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( 4. INTRODUCTION 


This manual describes the programming features of the UNIX system. 
It does not provide either a general overview of the UNIX system or 
details of the implementation of the system. 


This manual is divided into two sections, some containing inter-filed 
sub-sections: 


@ 1. Commands and Application Programs: 
1. General-Purpose Commands 
1C. Communications Commands 


@ 
® 
e 1G. Graphics Commands 
® 


6. Games 


Section 1 (Commands and Application Programs) describes programs 
intended to be invoked directly by the user or by command language 
procedures, aS opposed to subroutines, which are intended to be 
called by the user’s programs. Commands generally reside in the 
directory /bin (for binary programs). Some programs reside in 
/usr/bin to save space in /bin. These directories are searched 
automatically by the command interpreter called the shell. Sub- 
section 1C contains communication programs such as cu, send, uucp 
etc. These entries might not apply from system to system depending 
upon the hardware included on your processor. Some UNIX systems 
might have a directory called /usr/bin, which contains local 
commands. | 


Section 6 (Games) describes the games and educational programs 
that usually reside in the directory /usr/games. 


Each section consists of a number of independent entries of a page 
or so each. The name of the entry appears in the upper corners of 
its pages. Entries within each section are alphabetized, except for 
the introductory entry that begins each section. Some entries might 
describe several routines, commands, etc., and in such cases the 
entry appears only once, under its major name. 
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All entries have a common format, not all of whose parts always 
appear: 


NAME gives the name(s) of the entry and briefly states its 
purpose. 


SYNOPSIS summarizes the program being described. A few 
conventions are used, particularly in Section 1 (Commands): 


Boldface strings are literals and are to be typed just as 
they appear. 


Italic strings usually represent substitutable prototypes 
and program names found elsewhere in the manual. 
(They are underlined in the the typed versions of the 
entries.) 


Square brackets ([ ]) around an argument prototype 
indicate that the argument is optional. When an 
argument prototype is given as name or file, it always 
refers to a file name. 


Ellipses (...) are used to show that the previous argument 
prototype might be repeated. 


A final convention is used by itself. An argument 
beginning with a minus (—), plus ( +), or equal sign (=) is 
often a flag argument, even if it appears in a position 
where a file name could appear. Therefore, it is unwise 
to have files whose names begin with -,+, or =. 


DESCRIPTION discusses the subject at hand. 
FILES gives the file names that are built into the program. 
SEE ALSO gives pointers to related information. 


DIAGNOSTICS discusses the diagnostic indications that might 
be produced. Self-explanatory messages are not listed. . 


WARNINGS points out potential pitfalls. 


BUGS gives known bugs, and sometimes, deficiencies. 
Occasionally the suggested fix is also described. 


A table of contents precedes the first section. On most systems, all 
entries are available on-line via the man(1}) command. 


2 Sys5 UNIX 


— 


CONTENTS 


1. COMMANDS AND APPLICATION PROGRAMS 


1. COMMANDS AND APPLICATION PROGRAMS 


{18 | 0 Sener epenRe Ter ernrey introduction to commands and application programs 
OO Bese Soeececeeiouestacvaresees handle special functions of DAS! 300 and 300s terminals 
GO 1G iia ede hii etetceesateasiieteeeneas paginator for the TEKTRONIX 4014 terminal 
BDO iro secencencelge aes tegieveneeess ee handle special functions of the DAS! 450 terminal 
BCC LCOUN eo otcsesasscniaseneiieerecseetnstacense search and print process accounting file(s) 
AOD aseceuedeser vent esevaccudcsdeotads oe ecbenesiuyanedaves tiveet bade teessetlaceesiiecdiaueis absolute debugger 
CUMIN cnc Cosas davistececseseveueb cecesbuesertesssstvvedsnseengeds create and administer SCCS files 
BE cavec ores apuscriecewtexcesenceveeins archive and library maintainer for portable archives 
AUG ciceesitseiccecesine’ convert archive files from PDP-11 to common archive format 
BS sors ou dela a Wosidec Scie svaaiot sauce caeaac stl beens duamassedeaconencecoenede@econateins common assembler 
BSE siesta vac cenessidaaevcndoaseavswssdnesaste<tvess interpret ASA carriage control characters 
Eee set agccesa ates ceacaceer ea eee anes execute commands at a later time 
PAW csidorousecdcGeudicacewaceveoswudvaseesustoiatee pattern scanning and processing language 
DARING E osea cS siccasr cna corerate vost cacaertdeevebenswcececa seas uekdeuscuwss shastascottaseeeessere make posters 
Lo: | gene ee EE Re NT ee oe mF Peer GAO a Berkeley archive and library maintainer 
DASOMAINIC i siicnccesseusevecessdcaveeessavassonsssecacausersectseanss deliver portions of path names 
BDAC 8 oiasecccedles eves ncdi cous Sacekucsacetiesaseteentciuaacssiaces print large banner on printer 
DG aed esa talc cecs ienauaawene ce ceesneen cane Oanenee: arbitrary-precision arithmetic language 
DGUED oics cs ccvrcesy vay coceirevocesshasenesteatuuetavevesaniecoodueseiue chudesducesetyecssiateaaneieanaa eee: big diff 
TOES es cvdee acess ee ca dees bes deca tnd enue nn Ges saiae coe cedtaw cane Su penceeenetnaceteesteass big file scanner 
ROIS as Sete ds eee sewscs vawcacetec co ntaaasepesacastevebusdoudepesstansereeseeesteess list contents of directory 
DS 2555 ocucacdsantevecnsnsnnss Gaawsacksseense a compiler/interpreter for modest-sized programs 
CAN acces stccecweaskaswdecssavwauuncontavancasecsveteeva sic ciccssceduanedete uss guctoupundetnaloustees print calendar 
CRON AN od cas seen vataunesxdeun swan siek wands saseisicaccuwous sing devs stews sentosseieuees reminder service 
Sa sesh wa soc cccceae vac eu cacn cus Counc onuneuesterciiguieeneseeucuuceseesees concatenate and print files 
Di catamasa tired sbchcs ies coveusenus cases ecaaesiGaswacin veceesdeorcaeesaekasseveuaeeieies C program beautifier 
OO gaa ca se oss arn aw close acta sueceetan ovaudioweateasasectscwuesdtenssasneetopae tee C compiler 
OO as cecac ca thRereseeauketehavavartan cvevan evan suenuceeseseccsueeeistacoruacecssce change working directory 
COC oe doseeatetannanicenceececcaiceriveseasas change the delta commentary of an SCCS delta 
CUO suds ca caeieveceabidh reson suscaea sate leatende Geen stiavateceeeicantespaneets generate C flow graph 
CIITIOG acl viviscc ss toccusiciveluasnctwowaudencnteossuseuncesewevascasseseuessaecacousereeneeaeseneaes change mode 
CIO Wooo ce ste nous Wiclvd ews tea Gueaes Sines ciacee va cexceaseeauauecsdencesert change owner or group 
CIS AP eas atasarestasecenvecuauiatdavseusn du ddcebsacsnendeadouaecseue ee eeckasaseawebenees clear terminal screen 
CUP ses reclucnis sauce absakgeceudeacs cusecamwaduedeaunencauapen deacsessancesaesetexinctanss compare two files 
COE deetebe lect ccaes cue vesdeciceveaeescseebece ieee biaanta as teadar ese aea filter reverse line-feeds 
CONN asics rst tesetaccssvaveaseseiawaessvade satu ndedusesceoupvsdesassmeaanpeseecesbe combine SCCS deltas 
COMIN ses cats ciusvextresrerwderiesnesvausess select or reject lines common to two sorted files 
COD YLA PDC oes nevesentncincemeetapincsasncsweanuees cossecaaswdesseseree make an image copy of a tape 
CD ssi. aeeiekesie sepichalaeieS Sedan nsideundeenncuacaun edevaaveteccsstiaess sMisetielad teats copy, link or move files 
CIO assesses Grd streu swe ceceskveseeasi se adacdaeadesscaas ee neeuenes copy file archives in and out 
GDI aoside sissies canctunce enassakecodncavewiceaseved cesta ieuestacusnniees the C language preprocessor 
CRON scsi ad an ecie sata ied ocecisaant aban snaueeiuensectaseccuseetueucele user crontab file 
OEY DE iaricee ce nesiacane cased acttces ponds iiiad sd cvetea ee sdesupenaustesct neateeuseneuseeiecannds encode/decode 
CSI ai css cclev cs acatvosvebsatwttnstentcvane a shell (Command interpreter) with C-like syntax 
CS PON casei cas ae esas ncaa saad ane sect saa acodace ts Benecanwnedecseuenueteaudesutaventoneicclauee context split 
CU vances cacedetiawecucuexevaevesnbas uaseocenucnseaatuebanyasseceracses spawn getty to a remote terminal 
CRAG S is vitednwdivacscuouewescuvecswsgeSavessdedecsseneseaeue adorei nue wuss suseeaiacuietciaste create a tags file 
CU ACC soa soc dese euceea een neces wornaaatastcunscs Losdactecesesetaacedseweecsaaaes C program debugger 
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CUE hcl iss ca udadeunduaodnae d5nhsaiensenacesteesvieneaemnenk uses sasneassvetaceeas call another UNIX system . | 
CUNY sais feces cesses cc sdecs coaencuncc seeotceaitond: cut out selected fields of each line of a file i 
CK OY oie ycuecde occscs eine van sudecebunteletennsneeeiniesseatncee generate C program cross-reference 

ANS aaa doseu sa capezetaassxeadueeun ter sey neat cceneanvedeacecesecesexcendvuctaneets print and set the date 

hoa cs aces twos nee cased Pacesea ace eaiaavie saaees seueauw awe lacencesuubageesaeetveces desk calculator 

ON oa ceceaeoecan sce c cs Sensuan esncaerians cu ecewcaean tne sevens wn ponuaes co acs beeen oeets convert and copy a file 
delta.......... detcatoicena Hie watateces sapocan sta auean aes make a delta (change) to an SCCS file 

deroff .............. eater Mie As eaeaeie eek remove nroff/troff, tbl, and eqn constructs 

Co | | Fee ee Oe Aare ror ne Penner eee dial a Racal-Vadic 3451 modem 

EEG noi 002 cede Fetes a seel dented cae cadendhcs Shows saaheeaatnpem sancees differential file comparator 

UTES iodo asta eacecen ti centeestiwacediasuss ih eateratareecevanterts 3-way differential file comparison 

C205 14 6, eee en ee eo a oR en ee mark differences between files 

CU CITND esis ricci ees a el ee eee directory comparison 

esis ees Sansa Se apaesennses ons shan karteca tes cunencaucune toneounsienbaeenceseneaeate summarize disk usage 

MAUD os csvec ceed ussat esas tose dose sige veneer eeontenees dump selected parts of an object file 

KOTO vrs sicsscecacveetiercasieuew, prepare troff documents for the Xerox 9700 printer 

CIO ross cic hanes pa a acetates ccd ees acco es ne seo ceade tesa eee ess echo arguments 

OE acetic okey avecstverivuaceecsy cause denseacnco ieee vesWewuseeuseaesedeusseteserees easdetvecte atte LC GIIOL 

I os cides wsiewiecyasiasccexes aesvoapsveesecomenenre: text editor (variant of ex for casual users) 

OU oes ecetaaiccwanissvnnntiepedad daseauduasicancieuehevusussvassunananesabueanieee Extended Fortran Language 

SHAS csccsinicseseeescsienscavtdie eeciuente eiannieece Soseeneeesteeee .....enable/disable LP printers 

COI a teiavaneacevin tncesueescsvarsccsseuwiecieneanuanse set environment for command execution 

<2 | | Rene aa Sear ca el Oe Pe Tn ne Neat ROE NRE eS format mathematical text for nroff or troff 

ON cswearvevicesuaveccaneatetcosavanseusdessspags Seacqey cou ceeuseasneexesecsentesesueuswe cen cavsaxcosuwaess text editor 

OK OE wasecs censor tea rosnn ious vac a teasa eae eeseek eee evaluate arguments as an expression 

MT oe trakcaueuts cave et et caswcutees ten aus ludetausisouacnieassaisaiadsseeexeebeeuecotoees Fortran 77 compiler a 
VACCON ove scas we execs Seve enelda odes teeinc ka ctaedtat uae det venta strap Teaseesaeetyese factoranumber 
MG ien gus easts ule cect ety Saruva dated tates stanauicdicn tase tis tustacate bea aeeeansceenes determine file type age 
MVONGE sins csi deco ses cacsecscs eu axs savousasusannsismeuuseadonscsuwuapusueedastantecsbsenssaetecswureassterane find files 

ESD UI srctacecicnduc cece ceseneavhasectusdsaeecaasenseacussaewrecdeisedeueweseeees split f77, ratfor, or efl files 

OY secaccedaieucusba sod cueneeus cndutetaucceinsiuseuievendees graphical device routines and filters 

SS voice satecaceuicucsiwseucanvacaustuigesasie ves conetaiuassueonactesteaaveanen iaveteensnaueeses graphical editor 

OE sss tenaeacaraes tal tae ire ety ales be aeeesierdataserweetsannarte essences get a version of an SCCS file 

OO aaa sess sauce de cues wav caca cues buosge ahha enactendacens parse command options 

OF oss esstecnsscsns caus wesueseaaccsdie wads deasdcivbe ponautedsens tea excansensucucycouaccsantenss draw a graph 
GRADINGS siiicd cs cagassswstek shdesstectiatasts ..access graphical and numerical commands 

TOO asc is fast sera b ban nicnee sete eeade ne duerasiacacdencbaxcaescuotsdeossseneeeewiaske select terminal filter 

QOD sicciicdeteredeastediasucs SeetcesiecetoavsapecniavcGeersavenvenieccuedecaseees search a file for a pattern 

UE yodokcraicctecauseadec ticteueuacstares eect vumaune- aaudacnieisoeenateeia ees aceatendene graphical utilities 

OGG cowecercnsdessisesnccdsacusvoucsssmiaheeterwWensauases ner aenivnses give first few lines of a stream 

OUD iaiiccgdtcincscpcussicecsccocevens scares aaseusssucevodusa cob aaguatadedh cov catormeueutesauew seeaeaeeeees ask for help 

DD Sossewsieenaesiane handle special functions of HP 2640 and 2621-series terminals 

PY UNO sis sh ss cc Saac tests ec eee sa ieneec en etaaneoeneceeseneoesaes find hyphenated words 

NG Sevsavceswncesisekas scceuawwesias doswaseeencdstentesiee ean ctacts print user and group IDs and names 
IPCIM............068 remove a message queue, semaphore set or shared memory id 

WOGS soncosexedecevaacsssteactvsnateence report inter-process communication facilities status 

JOU 20.0... cesses ssscccccececccnessecesesseseeeeserecsscscesecseercseeseeeeeFelational database operator 

BUN cose ssc. Bias esiak pe cusna lance cece euau takes biteale cuales nue Sauenna sean tancoetea te terminate a process 

NG sssadeesviccetateiesdeas sieves tcosaccesatusecdededacauseteiasaheceus link editor for common object files 

NOK hiss oasis cows hiecs on veceunesomvadeasen sued generate programs for simple lexical tasks 

MING soca soa lceasanes sthsces coudcaeu-tateiaswoavsnbenceeqedouvecseadencscdantvasusesenGsanseusiiersies read one line 7 
AUN Sirsa asd eden cass sant aeee oe Nea a eee aC program checker “ ~ 
NOCD ois Faas acts cases vais cat cts ouptec eects awed ustecercgewecewewoseueescaves sono seu eateencheeees sign on Nee 
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LOT ETN cscs sich sidg so sense saad ces oes da decease cca vane cancee ve vereumedciemnce dene get login name 
Cod 2 [4 geean sere eyes nar envn neon Ropar Emenee r find ordering relation for an object library 
US eciasostawweivace eectis sees atescaeatea send/cancel requests to an LP line printer 
HOINONG esscssoscid eccecaa conser ta cvonee hc dees bee enctevecte, postpone printing, resume printing 
UES Rea ose esas te asses es ee ee ace print LP status information 
Ca PR reer Ea eT eRe erent ee ae eee ee tN list contents of directory 
INN oh dels osc asiewcealdeie St eticcecantedansatesenescueeee cde cacksscceseseeeasunetestecsasee macro processor 
MACIG hii ceria gen andes produce cross-reference listing of macro files 
ial) cease erating este eee ese send mail to users or read mail 
PUVA K cian cc sracvcceussas lac vedsPeuiedapipuniewcdawiae tennis interactive message processing system 
PAK Coc. bssecesuadeeedesath ices maintain, update, and regenerate groups of programs 
VAG OY cacs cove civeas cee cacc case scatuiecs wasndng es cenaenenees caneeeese generate encryption key 
IVAN assis chewcaicdocacdicndenseexcestsen te Sonaysctawadesyddecewdeavesd <bucetir eas print entries in this manual 
TVO SO sa sacetec cantscaes arcsansecacuucsbonvapuncaweaseuatucaeseveneeeeeakotscaras permit or deny messages 
PYRE 5 asks ce dos cw sate sna soceaceucapencinwsvisvaesae seep uacenvonseteueauexwondeedeguaewenee make a directory 
IVS ICS 0 ease deas ce secenvceeesaceceees create an error message file by massaging C source 
WTI 25s cacawetheccsentesiceesseoeeees print/check documents formatted with the MM macros 
LEATE SLL) | Genres ene Peer renee sroff/MM nroff/MM document compatibility checker 
MME sete earned typeset documents, viewgraphs, and slides 
TIVONO ices od ian t etwas sxeschldactesceevsetenmskee aauteisueetadesvenien file perusal filter for crt viewing 
WIG WIONIN cp escyacess tess tiae Secenspeatacsncanesiseuiveps econ eedees change the format of a text file 
ROWE oie cee occtbaieta gies ese Soe eancsveuseusnacteuseucancels tosteebenvausboarenewess log in to a new group 
VO WS sss Se cee isn vecece cd yas edna usw be sasnnsosdewican aces Pade ccneuaatensereseconateon as print news items 
NCS. Gocavcsgccdiva baccarniescoad Sdacasvdaravateuasecsteanecosesesuene run a command at low priority 
OU asec Ss cigaeieetsae sace aa Gao vic casa ae caves euencnecada ovavek eect aease line numbering filter 
PUPNY see ce eavereeeeceten dda teceangevescedeases esendaioweneess print name list of common object file 
RONUD acu. decsscccsvevensescaies sacheusyexen run a command immune to hangups and quits 
OUP OU corset destietsyetee ces aneseucedas uty Si anutiaacsagar.tcuinceandeavaeeeszestiecss format or typeset text 
COW vicocewess acs cecestuteedescuesindescecseaminctenseeegeeates prepare constant-width text for otroff 
OG oie Seis tsawirenct cand cou cea eteaneGvbes cudvacabealinandcauesteacadecand esaneeaseeneceansetneeaivanene octal dump 
DACK ceesnsssietaes ortdetencaacsei coves tentnsauserniasaGusceswes ccaasacsansvecs compress and expand files 
ASS Wiss sesso cau ndadusven eeeahad cxlsneue srouubuss cana cetorevounspnatariees change login password 
paste............... merge same lines of several files or subsequent lines of one file 
DG ei ccseceseraseccencdes casa seic se csnts es eieusi cue wikawadse file perusal filter for soft-copy terminals 
DiC esccs coecses seecis cece areceeuds teuecken nase troff preprocessor for drawing simple pictures 
DON eradns at iaheene oad ca cde vobwiucbe coh waale ves winslow sveasuawouewe ests alawuee ten eev iene tobesouacace print files 
POPC OHI eae oisick ew ceic ciate acc eereshiepe useceus vatewieheeeeecssiesese print out the environment 
BOUT ciicsbascie see re baa os pe ats educa va batea aig aa Gee wicte ce tae teweeecasan wand oovoudausas display profile data 
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BW anos oa ead saacic nea tess cms ec wlccdeueacsnwassssucasetamacweee ees working directory name 
PARI OR secceeciseccncss secksecaevcacaaneaace ealicaautdusVatandecesaripacteseasewsaeates rational Fortran dialect 
OCCU ois race weck hes ssn and ni cancvcntih eesewousetuaete .fegular expression compile 
-TM........ ceseventane esteem iueltd habidaeucadaieesteuingsvonentakareses ....remove files or directories 
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SOD os as ssceasns ton sccsi sce cdsccn is ensecendseeaceiveideesedeocse side-by-side difference program 
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DO ON ae iiecicuccedeceeccutseciwuncucs ca gueteereaenets bool(3F) 
DIC. SYSIGMIN: cccdstecctcassideecsssishotenedieciees brc(1M) 
DIGESE ssecencess Ga coatuavecenccastespcasensmoheidesscess brdrst(1M) 
brk change data segment space ....... brk(2S) 
Dt CHAN GC vccscdwavieek ccsensceassentavecslenveces brk(2) 
bs a compiler/interpreter .................. bs(1) 
ISSO Al CW cesece-seencecisccutavstececateecevensteeseees bsearch(3C) 
buffered input/output package ......... stdio(3S) 
buffering to a stream setbuf, setvbuf setbuf(3S) 
build special file MknOd ................000 mknod(1M) 
DYIGS ‘SW « sesccvcapesessciewssesesuaiecnanerexics swab(3C) 
Communication Processor’s ............. vcpdmp(1M) 
caching reel-to-reel tape driver ........ rm(/) 
Al. socccepenscedeses avanceuacecnenedsenovensaeewieeasees cal(1) 
CalCUlalOl GC’ secpssicsceiatsceesisadesvecicteieted dc(1) 
GaleNndar Cal > ascciscesecstivedcesnsseceseicadionets cal(1) 
Calendal: c.ssicticsaccecMercssiewes wiuvetivuseeess calendar(1) 
call another UNIX system ...............00 cu(iC) 
Call Stal ie ceccucvey enlace ueesuesencaveacecenecuecoauce stat(5) 
CANS TK ses ccaescnsiiecabsccnacecccsuceessncesSsecsne link(1M) 
capability data base terminfo ............ terminfo(4) 
carriage control characters aSa ....... asa(1) 
Cartridge CONtrOM EL 20... eescceseeeeesceees ft(7) 
Cartridge Controller ...............ssseccscceees pt(7) 
CaSuAal USES) Cit .........cceccsvecesccesvevees edit(1) 
cat concatenate and print ................ cat(8) 
Cal sausichicsteliesidiasuntetetatiicne COtd) 
CD ea vecierseseeeneaseeeeatsete ceutasechaacoeeaceeaeen cb(1) 
CG cs dade wewatenancvecaenuavesveteeccegsacecukevenessseecs cc(1) 
ccb common circuits board ............. ccb(7) 
OD sesso erates eae Oiss yeas ictaseieainseanetataeeeees cd(1) 
CG dcsiyea tic uecectectadekecdslecceveseetlessicuesessneees cd(/) 
CAC CHANGE the 2.1... ..cecsecesccssccsecreccee cdc(1) 
cdconf configurable disk ............. wea. CACONF(1M) 
ceiling, remainder, absolute ............. floor(3M) 
CHOW -edcssvicestenvweeSenticeaus cess totsuensetebrusecs cflow(1) 
change data segment space ............. brk(2) 
change data segment space ............ brk(2S) 
change login password passwd ....... passwd(1) 
Change Mode CHMO .........ccsesseceeees chmod(1) 
change mode of file chmod .............. chmod(2) 
Change mode Of file .......... ett eceesee scenes chmod(2S) 
Change or add value to ...........ceeseeees putenv(3C) 
change owner and group Of a .......... chown(2) 
change priority of a process. ............. nice(2) 
change priority of a process ............. nice(2S) 
change root directory chroot ............ chroot(2) 
change root directory for a ..........0008 chroot(1M) 
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change the format of a text .............. 
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change working directory cd ............ 
change working directory chdir 
change working directory 
CANNES! DIDG wavs aves casccesexsdssdesssaceea eee 
character back into input stream ..... 
character definitions for eqn and ..... 
character login name of the user ..... 
character or word from a stream 
character or word on a stream 
character set ascii 
CHAraACtePriSltCs cvs ccscecsisseteccessiesiadcesseess 
characteristics of a document 
characteristics 
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characters ctype 
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checkall faster 
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checking procedure checkall 
checking volcopy 
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checksum and block count of a 
Child PrOCeSs tiMES ........csesecssessesceees 
Child process tO StOP OF 2... ceeeeees ees 
chmod change mode of file 
chmod 
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Circuits DOAI iver .........eeeceeeeeeee eens 
classify characters ctype 
clean-up uuclean 
clear i-node clri 
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close a file descriptor close 
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close or flush a stream fclose 
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CINDY 65 icorc wav acdeceese des uaccrs au iaeswocnso sates. cmp(1) 

CON Sie focec rac ecacvelueceitape seer deaaeevie eee: col(1) 
combine SCCS deltas comb ............. comb(1) 
CommM Select OF FejeCct .........ecceeesseeeees comm(1) 
command at low priority nice ........... nice(1) 
COMMANA CHrOOt ........cceescceceeceecssccnses chroot(1M) 
COMMANC EXECULION ENV .........cccecseeee env(1) 
COMMANC EXECULION UUX ........ccccceseeee uux(1) 
command from Fortran system ......... system(3F) 
command immune to hangups and . nohup(1) 
(command interpreter) with C-like .... csh(1) 
command on the PCL network net ... net(1) 
command options getopt ..............608. getopt(1) 
command programming language ... sh(1) 
command SummMary from ..........cceeeeee acctcms(1M) 
COMMAN SYSTEM .........ccccsccsecesscesscens system (3S) 
COMMANG tOSt ...........ccccccsensccecscescscenes test(1) 
COMMANG. THING se cccssdsasecscsvecdacesenticovesss time(1) 
Command xargs CONStruCt ...........000 xargs(1) 
command-line argument getarc ....... getarc(3F) 
command; report process data and_ timex(1) 
commands acct of accounting ........ acct(1M) 
commands at a later time at ............. at(1)_ 
COMMANAS QraPhicCs ...........ccccceeeeeeees graphics(1) 
COMMANAS INStall ...... eee see tece ewes install(1M) 
commands stat statistical ................ stat(1) 
commentary of an SCCS delta .......... cdc(1) 
common archive file format ...........00. ar(4) 
COMMON archive fOrmat .........cssseseeees arcv(1) 
common archive format ........ccccsesceees arcv(1) 
common assembler and link editor .. a.out(4) 
COMMON ASSEMDIEL AS ......cecececeeseeeees as(1) 
common circuits board driver .......... ccb(7) 
common logarithm intrinsic .............. log10(3F) 
common object file ACCESS ............000 Idfcn(4) 
common object file for reading ......... Idopen(3X) 
common object file function ............. Idlread(3xX) 
common object file Idclose ............... Idclose(3X) 
common object file Idfhread ............. Idfhread(8xX) 
common object file Idiseek line ......... Idiseek(3X) 
common object file Idohseek seek .... ldohseek(3X) 
common object file Idrseek ............... Idrseek(3X) 
common object file Idshread ............ idshread(3X) 
common object file Idsseek seek ...... Idsseek(3X) 
common object file Idtbindex ............ idtbindex(3X) 
common object file Idtbread an ....... Idtbread(3X) 
common object file Idtbseek ............. Idtbseek(3X) 
common object file linenum .............. linenum(4) 
common Object file NM ..........ccccsececeee nm(1) 
common object file reloc ..............c eee reloc(4) 
common object file scnhdr. ............... scnhdr(4) 
common object file strip and ............ strip(1) 


common object file symbol table 
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table entry of a common object 


cat 

test 

utility cdconf 

cd 

ioctl.syscon system console 
vceonfig virtual terminal 
_cdconf configurable disk 
dconfig 

dconfig 

Ipadmin 

conjugate intrinsic function 
conjg Fortran complex 


an out-going terminal line 
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fsck, dfsck file system 
messages from UNIX to console 
ioctl.syscon system 

of error messages from UNIX to 
ocw prepare 

math functions and 
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common object file symbol table 


ee syms(4) 
common object files filehdr ............... filendr(4) 
common object files Id... esse ee Id(1) 


common object files Size ................6. size(1) 
common to two sorted files comm .... comm(1) 


communication facilities status ........ ipcs(1) 
communication package stdipc ....... stdipc(3C) 
COMPAFAtONr Gill. cececccccissivacccedeneesteredees diff(1) 
compare two fil€S CMP ...............ceceee cmp(1) 


compare two versions of an SCCS ... sccsdiff(1) 


comparision intrinsic functions ........ strcmp(3F) 
COMPALISON GiffS ...........ecee ces ecescereeeees diff3(1) 
COMPALISON CIPCMD ......... eee eee seeeece neces dircmp(1) 
compile and execute regular ............ regcmp(3xX) 
compile and match routines ............. regexp(5) 
compiled term file term ................ce0ee term(4) 
COMPUCI CC i cciccesacicesasesesteretcscsesansesdes cc(1) 
COMDUCE TCT 2 oicieiccssscesssesp eed eosenes f77(1) 
compiler for stand-alone programs . scc(1) 

COM PDHOE TiC’ eacccscs cede iidwecaaonavesioieorecers tic(1M) 
compiler-compiler yacc ..............ceceees yacc(1) 
compiler/interpreter fOr ..........eeeeceeee bs(1) 
complementary error function .......... erf(3M) 
completion Of PrOCeSS .......... eee eee wait(1) 
COMPI|eX AFGUMENT 2... eee eeee seco eee aimag(3F) 
complex conjugate intrinsic .............. conjg(3F) 
compress and expand files ............... pack(1) 
compute the index of a symbol ........ Idtbindex(3XxX) 
concatenate and print files cat ......... cat(1)- 
concatenate and print files ............... cat(8) 
condition evaluation command ........ test(1) 
configurable disk configuration ........ cdconf(1M) 
configurable disk rive ............-.seceeeee cd(/) 
CONFIQUIATION FITS L...c.eeeeccecceecceeeeeeeees ioctl.syscon(4) 
CONTIQUIAUON, sa cciasccneccssssencnsmrndsecctesecus vconfig(1M) 
Configuration utility ......... cece eeeeee cdconf(1M) 
configure logical GiSKS .......... ee eeeeees dconfig(1M) 
configure logical CiISKS ........... ce ceeee eee dconfig(8) 
configure the LP spooling system ..... Ipadmin(1M) 


conjg Fortran Complex ..............seseeees conjg(3F) 


conjugate intrinsic function .............. conjg(3F) 
connect-time accounting acctcon .... acctcon(1M) 
connection dial establish ................. dial(3C) 


CONNECTION INfFOrMAtION .............cceeeee L-devices(4) 
consistency check and interactive .... fsck(8) 
consistency check and interactive .... fsck(1M) 


Conslog COPy Of EFTOF qu... cesses eee en eee conslog(7) 
console configuration file .................. ioctl.syscon(4) 
console conslog provides copy ........ conslog(7) 
constant-width text for otroff ............ ocw(1) 
CONSTANIS MAU ccs cccwteebedceaiced teases math(5) 


construct a file system mKfs .............. mkfs(1M) 
construct a file SySteEM 0... eee ee mkfs(8) 
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file 
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dd convert and 
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construct argument list(s) and .......... 
CONStructS GerOff ...........cewseesesceeeoeees 
contents Of GiIreCtOrieS ............eeeeeeee 
contents of directory IS ...........ceseeeeee 
CONTENtS FOUTINES tOC ........ceeceeeseeseevee 
context Split. CSDUITL: cs sivsnceseccesseseresescesds 
CONtrol Characters ASA .........csecseceesees 


control operations msgcttl ................. 
control operations semctl ..............0. 
control operations shmctil ................. 
control Options fentl ......... eee eens 
CONMTOl UUSTAL xcs eececiertaerstcseveesecoseues 
GONRVIOL VG ssxi cen dieaces scpicssenescavearsaecdenwees 
CONMIONGD cceccesccesvoaissvausiexcasweswedisascesaes 
CONMONUCE cccsciiessinsdascieensssctadiedescse ees 
CONTIOUGR siccccescsiseneceniecebcwscnisesnsauuacnes? 
CODY sicccicsccpsnarsaueaveeicas tae sedeavedeasavyncgutan 


CONVETSION ftYPC .........sccccsccescenccereseces 
conversion program units .............00 
convert and copy a file dd ................ 
convert and copy a file ................0000 
convert archive files from .............cs00 
convert between 3-byte integers ....... 
convert between long integer and .... 
convert date and time to String ........ 
convert floating-point number to ...... 
convert formatted input scanf .......... 
convert string to iINteGer .............sseees 
CONVENT STHING 10 cissesccceececsstesdecannseeess 
copy a file dd .............. weicepewetoleerevensiee 
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copy file archives in and out ............. 
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copy file systems with label ............... 
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copy of error messages from UNIX ... 
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CODY i vascaneeucsepcaveiteuatsauedeetisewcencusaceeaeesy 
copytape make an image copy Of .... 
Core image file COLE ........ ccc csscseseeee eens 
COE MEMOTY MEM .......ccsseereccersereerees 
cosh Fortran hyperbolic... 
cosine intrinsic function cosh ........... 
cosine intrinsic functions Cos ........... 
COUNT Of A FIIE SUM oe... eee ceecenceeeeeceeene 
COURT WG “ase ccsiescastcnctnesstesdevevewssdeasverss 
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cpset install ODject 2.0... eee eeeeeeeee cpset(1M) 
CLANS Cla DS: cnciccwscscuudupoaeseteecewsvadaseses craps(6) 
GRAS: cecdeas enw cass cearcaeanssecdeusecenacsatcreones crash(1M) 
GRAS. WINAU ikscsecvoseveteaweed sate tteceescestees crash(8) 
Creat Create A NEW ........ccsceccsceccnceececs creat(2) 
create a name for a temporaty .......... tmpnam(3S) 
create a new file or rewrite an ........... creat(2) 
create a new process fork .............c006 fork(2) 
create a new special file ............ eee creat(2S) 
create a temporary file tmpfile .......... tmpfile(3S) 
create an interprocess channel ........ pipe(2) 
create and administer SCCS files ..... admin(1) 
creation MaSk UMASK ............ccecsececees umask(2) 
CFEAUON MMASK wikccdcnceieliisscivsceesstetectec umask(2S) 
crm caching reel-to-reel tape ........... rm(7) 

cron - Clock G42EMON CION ..........ceceee cron(1M) 
CUONAD: Sescicssendsecvoesaciuesnestusctaveacdesetcess crontab(1) 
cross-reference CxIref .........csceeseeeeerene cxref(1) 
cross-reference listing of macro ....... macref(1) 
CLV U tincdicyicineves vaieueomabe sar cuneedetaneeacecscasene crypt(1) 
COV ON sch cae ont eaventawedt aver ac weseevwetcenuaees crypt(3C) 
cSh a Shell (COMMANG ..........cecececscevee csh(1) 
CSDM terns ianebawsatiaresacseatececnccateeewatee csplit(1) 

GU devscaun ce acesGubeeh sbulesbavevadescesetecseeeneneneee ct(1) 
GLOTINMIG, sacscescaucccesseicenens ureoesseabacecasscaase ctermid(8S) 
CUM Ge decane Seiceccddatyaceteeneta eteskaevnsaenssess ctime(3C) 
CU ACG cevacatutiteceessdeauniecsretisexoneageeesveins ctrace(1) 
CIV Det cities Rect ecntesacaucneatsteseunees ctype(3C) 
CU Call ANOtHE .......... cece eeeeesseeecceeeeees cu(1C) 
current SCCS file editing ................08 sact(1) 
current UNIX system uname .............. uname(1) 
current UNIX system uname ............66 uname(2) 
Current user ttysSlot find ...........cssscceeee ttyslot(3C) 
current value of a file pointer ............ tell(2S) 
current working directory getcwad ..... getcwd(3C) 
Curses CRT SCION ou... cccecnecseceeeeceeee curses(3X) 
CUTIVE’ SDINNGS vusscsecctacssabessvuncddeeassiondededé spline(1) 
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GACMON ClON. sdissessixeescccccssensdechesweccenss cron(1M) 
CACMON EFFCeMON ......csscecsceecscecscecsees errdemon(iM) 
CIACMON CFIStOP 2... ceccecsevescesceseeeeecees errstop(1M) 
daily acCOuNtING FUNACCE .........ceeseeees runacct(1M) 
daily/weekly UNIX system file ............ filesave(1M) 
data and system activity timex ......... timex(1) 
data base of terminal types by ......... ttytype(5) 
data base of terminal types by ......... ttytype(5) 
data base terMinfO ........c.ccccesssccseeesees terminfo(4) 
data by user ID diskusg diskusg ...... diskusg(1M) 
data in a machine-independent ....... sputl(3X) 
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lock process, text, or 
display profile 

stat 

change 

brk change 

primitive system 
relational 

query terminfo 
download program files 
convert 

print and set the date 
desk calculator 
lpadmin 

configure logical disks 
configure logical disks 
systems for optimal access time 


convert and copy a file 
absolute 

C program 

file system 

fsdb file system 

eqnchar special character 
basename 

tail 

delta make a 

the delta commentary of an SCCS 
cdc change the 

remove a 

a delta (change) to an SCCS file 
combine SCCS 

permit or 

tbl, and eqn constructs 
device-independent troff font 
troff 

close a file 

duplicate an open file 
returns a 1 if specified file 
close close a file 


access 
access 


control 


graphical 

font description files for 
L-devices link 

device name 

report number of free disk blocks 


consistency check and interactive, fsck 
consistency check and interactive, fsck 
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data in memory PIOCK .............-scceeeee plock(2) 
Catas DIOR uesriea leas esabasarereuvodensieeessees prof(1) 
data returned by stat system cail ..... stat(5) 
data segment space allocation brk .. brk(2) 
data segment space allocation ......... brk(2S) 
Gata tyPes tyPeS 0... ce cceweceeweeeee types(5) 
database operator join ..........cceceeeeees join(1) 
Gatabase tput .............ccccsecesccesecccocees tput(1) 
CAAIOs cep cseuscertescastensciecdormessecneneeaniad dataio(1M) | 
date and time to string ctime ............ ctime(3C) 
AIC ies ee vec eens scue canctanndaedapedaddcveawenevicaeas date(1) 
OG peat oa eset ese tac ssa vee dah caeaeeeinen aes dc(1) 
configure the LP spooling system ..... Ipadmin(1M) 
GCONNG sescetistseecuis crcl ceccinelictusa route ves dconfig(1M) 
CONG es nkte se cccacdaweeatcceuuaneeee otseeenes dconfig(8) 
OCODY CODY TING sonia ieiccesccenndstecacsddciassics dcopy(1M) 
dd convert and copy a file ................ dd(8) 
AG prccctuntcadecuevans dacketatcnosacdvensacets niawhoseens dd(1) 
GEDUGGEN AOD: a. dejenkeinsieedecnecevecess wenseees adb(1) 
GEDUGGES CIACE ..... et ceceeceecneeceseseees ctrace(1) 
debugger (Sd Do sssesiseviciwieneeveseseckeweaes fsdb(1M) 
GEDUDGEl sevecocccdens a ideab accuse eakcueetowe cance fsdb(8) 
definitions for eqn and negn ............ eqnchar(5) 
deliver portions of path names ......... basename(1) 
deliver the last part of a file .............. tail(1) 
delta (change) to an SCCS file .......... delta(1) 
delta CdC CHANGE ........... cee seesscewsseweves cdc(1) 
delta commentary of an SCCS delta cdc(1) 
delta from an SCCS file rmdel .......... rmdel(1) 
GOHAN KS sessscccccasictecaewesceNeweteseaveenexet delta(1) 
GEIHAS COMD: cscsediivdvecsvsescenccocaveuesrsacsee comb(1) 
deny messages meSgQ ...........+. miwiseocese mesg(1) 
deroff remove nroff/troff, ........ccccseecees deroff(1) 
CESCriIPTtiON FIIES FOF ..........eeeceeceeeeeceves font(5) 
description of output language ........ troff(5) 
COSCrIPIOL ClOSG i siicsiccakecsacasaceetsnsossens close(2) 
GESCIIPION GUD: .iidessadebsaivaiseceaenctscssctoes dup(2) 
descriptor is a isatty ........... eee eeeeeee isatty(2S) 
GOSCIIDION seiaisideceecdeevaciceweeasieasencassees close(2S) 
desk Calculator dC ............ceccssceeeeeeeees dc(1) 
determine accessibility of a file ......... access(2) 
determine accessibility of a file ......... access(2S) 
determine file type file ......... ee eee ee file(1) 
GEVICS OCW cess aissecsrncneeies ioctl(2) 
GeEVICe NAME GEVNM ..........ececeeeseeenenes devnm(iM) 
device routines and filters gdev ........ gdev(1) 
device-independent troff .............seeee font(5) 
devices, connection information ....... L-devices(4) 
COVINA: sos iceseietirosedesccdavaawersensnsgoreienacess devnm(1M) 
ON, Seudces ete Gciscbe sesedoede eas eaatescsdeaskee cet: df(iM) 
dformat disk formatter .............ceseeeeee dformat(8) 
CESCK file SYStEM ............cceccccseecereseeees fsck(8) 
dfsck file system ..... pevietesectcaseuetcstedrat fsck(1M) 
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Re mdial 


terminal line connection 
rational Fortran 
L-dialcodes alphabetic 
d_passwd 

dialups, list of 

big 

differential file comparator 
differential file comparison 
dim positive 

side-by-side 

mark 


diff3 3-way 

mark differences between files 
difference intrinsic functions 
format of directories 
directory comparison 

install object files in binary 
format of 

remove files or 

Is list contents of 

change working 

change working 

change root 

uucp spool 


remove 
change root 

get path-name of current working 
list contents of 

make a 

move a 

working 

ordinary file mknod make a 

chdir change working 

enable or 

type, modes, speed, and line 

od optical 

rod raw interface to optical 


diskusg diskusg - generate 
report number of free 
cdconf configurable 

pd IMSP 

cd configurable 

dsk optionally mirrored 
dformat 

summarize 

du summarize 

ramdisk memory as 

allows memory to be used as a 


Plexus Sys 5.21UNIX 


PERMUTED INDEX 


dial a Racal-Vadic 3451 modem ...... dial(1) 
dial the P/75 onboard modern ........... dial(1) 
dial establish an out-going .............. dial(3C) 
GialeCt Ato’ sxerssiesiewecdaciciveiteemeeess ratfor(1) 
dialing abbreviations file ................... L-dialcodes(4) 
dialup password file ...............ceeeeceeeee d_passwd(4) 
CGialup GeVICES ou... tec eeeceecescceeer eens dialups(4) 
CUE OCI: sxc oeicevelees cacesceeuteerrieeeenae ace bdiff(1) 
IN sess crawessben se ceccavaiucesetotendeatstacecaettanaves diff(1) 
GINS S=WAY dsciccevedsievccsnceseateresnstoneenti ins diff3(1) 
difference intrinsic functions ............. dim(3F) 
difference program sdiff .................... sdiff(1) 
differences between files diffmk ........ diffmk(1) 
differential file comparator diff .......... diff(1) 
differential file comparison ................ diff3(1) 
COTE ossecc ces ea acs coccsactsnewsesseeevevseee diffmk(1) 
GUM DOSIIVE: sacesacassdcsecsteeakinsesxceseniareene dim(3F) 
ONE cateccnsentecsguacteedevezestonineiusaeecesseransaceies dir(4) 
CIN CIND: “ciaceacncucssbcrvaavareseusaiasicenversansepens dircmp(1) 
CFECtOFieS CPSet .........ccscceccssscsseeeeesees cpset(1M) 
directories dir ........ SoGrebanldsecegcdcasiecesaees dir(4) 
CHIECIONIECS TIM: e.cesiecetedtacereescasesctanvcs dee rm(1) 
CUIFECIONICS 2ssii ck coececterdenatasa eeeiatenveass Is(8) 
GIVECIOLY CO) sarciieisiecrencsonsinsncntess eerie: cd(1) 
CIreECtOry CHIL .........csccecseeccscceveecceceees chdir(2) 
CFECtOry CHOOT .......c.ceccsseccesccsscsseeeees chroot(2) 
directory clean-up uuclean ............... uuciean(1M) 
directory comparison dircmp. ........... dircmp(1) 
directory entry UNIINK ........... ee eeee seen unlink(2) 
directory for a command chroot ....... chroot(1M) 
CireCtOry GetCwd 2.0... cccceescssseeceescrnes getcwd(3C) 
CHEE CLONY 1S -cicariccinstuenssesa seed ceenntencesalees Is(1) 
CireCtOry MIKI ........ cece sccecccesceeceeseenees mkdir(1) 
GITECHOLY MVAIN qu... cescscsscecececescsceeeees mvdir(1M) 
directory NAME PW ...... ce eeeeeeeeeec eens pwd(1) 
directory or a special OF ..................4- mknod(2) 
CWOCIONY aisarsnceeeatieales Aewsesseaeeesacoesaens chdir(2S) 
disable process accounting acct ..... acct(2) 
discipline getty set terminal .............. getty 
ISK: ttlotecdAtecaseetiiniastuteerieiietuseateg oattes od(/) 
ONSK: sivtaecdsteterstetectseopeaardueeiinulciaccageiacs od(/) 
disk access profiler sadp ................6. sadp(1M) 
disk accounting data by user ID....... diskusg(1M) 
GiSk: DIOCKS OP xigjccsavedarewnceet nde pleneedstees df(1M) 
disk configuration utility .................... cdconf(1M) 
GiISK CONMWOMO!! saccccccadcasseecceseanccsaesesunee pd(7) 
CIS CEIVG: col ccsnredacccunwetedemeiawveccaussiwes it cd(/) 
CHSK: CHIVGN ccscasececeseascasecsiceccnecdstawsaceenee dsk(7/) 
GISK TOFMANC! acc sicsdeiesiiscasatermcessser ices dformat(8) 
CGiSk USAGES. sisssedissceanddicaeedicscsiceees. du(1) 
GISK USAGE wee. ccsisisesecdsscecnseaversenssessoexes du(8) 
ISI -nalincwcnes ius ciavcauocesletisabeessaesaveuneseedaess ramdisk(1M) 
GISK ANY a scerecetassisnetiussteeseaeatoccewosiekes rram(7/) 
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configure logical 

configure logical 
accounting data by user ID 
mount and 

screen-oriented (visual) 


Euclidean 

drand48 generate uniformly 
download program files 
download program files 
mmiint sroff/MM nroff/MM 
surface characteristics of a 
macros mm print/check 

MM macro package for formatting 
macro package for formatting 
mmt typeset 

who is 

intrinsic function dprod 

float and 

convert string to 

dnid 


check and interactive fsck, 
product intrinsic function 
distributed pseudo-random numbers 


pic troff preprocessor for 


provide 

cd configurable disk 

ccb common circuits board 
dsk optionally mirrored disk 
crm caching reel-to-reel tape 
rrm raw reel-to-reel tape 
driver 

raw (unbuffered) version of 


summarize disk usage 
Communication acpdmp 
Communication Processor’s 
Intelligent Communication icpodmp 
extract error records from 

octal 

object file dump 

dump incremental 

od octal 

selected parts of an object file 
duplicate an open file descriptor 
for the Xerox 9700 printer 


floating-point number to string 
text editor 

(variant of ex for casual users) 
print current SCCS file 
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CVSS: x5 ieceeiccssdencdesasedensassseesersqescueesoues dconfig(1M) 
ONSKS  accteGt cde esa eiscleeesnesataasenvovereeeeaes dconfig(8) 
diskusg - generate disk .............cseesees diskusg(1M) 
dismount file system mounNt .............. mount(1M) 
display editor based on ex Vi .........06 vi(1) 
display profile data prof .......... see eeee prof(1) 
distance function hypot .................00 hypot(3M) 
distributed pseudo-random numbers drand48(3C) 
CALAIO~ cc ccevecnwaaccieucseepcatestvssinswscouecesente dataio(1M) 
GAG: Saviors sieocud tau demracstescecaasectancosaceioaee dnid(1M) 
document compatibility checker ....... mmilint(1) 
document analyZe ............cccseeceeeeeeeee style(1) 


documents formatted with the MM ... mm(1) 
GOCUMENtS MM the .........seseseceeceeeees mm(5) 
documents the OSDD adapter ........... mosd(5) 
documents, viewgraphs, and slides . mmt(1) 


doing what Whoo ...........cceeeeesseeeeneee whodo(1M) 
double precision product ...............0 dprod(3F) 
CGouble rOutineS  ..........cesecseeesesecseeeees float(2S) 
double-precision number strtod ....... strtod(3C) 
download program files ................:00 dnid(1M) 
d_passwd dialup password file ........ d_passwd(4) 
dfsck file system consistency ............ fsck(1M) 
dprod double precision ................206 dprod(3F) 
drand48 generate uniformly ............. drand48(3C) 
draw a graph graph ............ccescsescesees graph(1) 
drawing simple pictures .................... pic(1) 

drill in number facts arithmetic ......... arithmetic(6) 
QUIS: reciccatencescesceasessescaansdcckwsscneeccareawwes cd(7/) 

CVIVOE 5 se dnes ceccsuaercatecaesstanedosncvesaeces ccb(7) 
CIV GT ance cxdaces ia ceeicanctavauevdvadsesuwcesinsiaee dsk(7) 
CAVED. eactsececoscectacccuseuctercoubsaeecescesdecaae ces rm(7) 

CHTIVON ew scetass cederccetaanentceucnccedocstuvassewacenes rm(7/) 

dsk optionally mirrored disk ............. dsk(7/) 

ASK POSK: dsasisceasdiesiedsscsseiscecueiiecaastax dsk(7) 

du summarize disk uSaQe ..............06- du(8) 

CU cievasousiadccasausteteseckenlawsedesesssoncetoaeesuaiae du(1) 

dump contents of Advanced ............. acpdmp(1M) 
dump contents of VMEbus ..............05 vcpdmp(1M) 
dump contents Of AN 20... eee e eee ee icpdmp(1iM) 
GUND CIFOSaG tiveninciticied et aeseenss errdead(1M) 
GUM DOO civesessasiiesssscreareorttioatndwures od(1) 

dump selected parts of an .............. dump(1) 
Gump tape format ........eceeceseceeewenene dump(4) 
CUNT? -Seccdteteisgeesdasteatachaedeate aoned eases od(8) 

QUIMD CUM Decne issins conndtecstteeseasisessnane dump(1) 
Ur on eevedevewscawsecueceaseteaweeeoeudeouseusaes dup(2) 
dx9/00 prepare troff documents ...... dx9/00(1) 
echo arguments CCNO ou... ceeeeeeesee eee echo(1) 

SCVE CONVENT: wiscsives crcstecnieaawyecanterorssiven’ ecvt(3C) 

COO ae wiateuadinteetiwoseanitacanttecencentesantbest wine ed(1) 

ECit text ECItOK oo... ec eeeeeteeceneecenee edit(1) 
editing activity Sact 0... cecceesseeeees sact(1) 
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users edit text 
screen-oriented (visual) display 
text 

link 

graphic 

common assembler and link 
stream 

split f77, ratfor, or 

Extended Fortran Language 
accounting acct 

enable 

for/ uuencode,uudecode 


generate DES 

generate 

Ist locations in program 

get 

linenum line number 

print 

manipulate line number 

object file seek to relocation 
utmp and wtmp 

get group file 

get password file 

access utmp file 

common object file symbol table 
the index of a symbol table 

read an indexed symbol table 
write password file 

remove directory 

environment for command execution 
user environment 

setting up an 

profile setting up an 

user 

env set 

return value for 

change or add value to 

return Fortran 

special character definitions for 
remove nroff/troff, tbl, and 

for nroff or troff 

and complementary error function 
error-logging interface 

extract error records from dump 
error-logging daemon 

error-log file format 
complementary error function erf 
copy of 

system 

extract 
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editor (variant of ex for casual 


packeaks edit(1) 

editor DaSed ON EX Vi ......se cece scene ee eee vi(1) 
CCILOR OX cise eacdswennadnansauncnciaccatdonstvahess ex(1) 
editor for common object files Id ...... ld(1) 
CONOL GEG: seeticciteceescaisaeeceeusinetn ged(1) 
editor Output a.0ut 2.0... eee ee ee eee a.out(4) 
CQGILOl SOG scschestesseesivapntaeeasesesnscedens sed(1) 
STITIES ISDE os caccieskdcseustsueceeescnyiniaees fsplit(1) 
Cll caesinged. necadabebelixcstacnvine weeteetansadssucees efl(1) 
enable or disable process. ................. acct(2) 
enable/disable LP printers ................ enable(1) 
encode/decode a binary file ............. uuencode(ic) 
encode/decode Crypt .............ceseeeeeees crypt(1) 
ENCrYPTION Crypt ...........ceeeceeceseceeeeeees crypt(3C) 
encryption key makekey ............cs00ec0 makekey(1) 
SING: avinwiecuoievacecceceradass ceilatden unaxveeeteduncees: end(3C) 
entries from name list nlist ................ nlist(3C) 
entries in a common object file ......... linenum(4) 
entries in this manual man ............... man(1) 
entries of a common object file ......... Idiread(3X) 
entries of a section of a common ..... Idrseek(3X) 
entry formats UTM) ......... ce ceeececeseceeees utmp(4) 
Entry Getgrent. ss csieceiiyscksteeeletraseess getgrent(3C) 
ENtry GEtPWENT ou... eee eescteecceseeeeeeeee getpwent(3C) 
CMIUY GOUUIE cia sesecccens eacecascaonwareis ticecececes getut(3C) 
entry Idgetname symbol name for .... Idgetname(3X) 
entry of a common object file ........... Idtbindex(3X) 
entry of a common object file ........... Idtbread(3x) 
ENtry PUTPWENT ..........seeeeescereeeeeeeceneces putpwent(3C) 
GNUYUNIINK. c..cenccscicecccnvestccedcces aevasees unlink(2) 
CNV SSCU essai ic ceccavaweiveccrissnsiienededeiecnsans env(1) 
CIVIFON sasscess aces hesataveuscdsectesbesscugciaxausee environ(5) 
environment at login time ................. profile(4) 
environment at login time ................. profile(5) 
ENVIFONMENE CNVIFON ........cccecncecsscecenes environ(5) 
environment for command execution env(1) 
ENVIFONMENt NAME ......ecceeseceececceeceeneee getenv(3C) 
ENVIFONMENt PUTENV ......... cece eee eeeeeees putenv(3C) 
environment variable getenv ............. getenv(3F) 
eqn and neqn eqnchar ............. eee eqnchar(5) 
eqn constructs deroff ...... ee eee e eee deroff(1) 
eqn format mathematical text ........... eqn(1) 
CM Grror TUNCHON iiss cove ccasweccensseacsece erf(3M) 
OEY sisapre tua tan eee coe earnest nad weaneneenienseine err(7) 
BITC A sath coscass ciweseeiicacdes iw cacauenenmcanshe errdead(1M) 
SIVOSM OO xii cele veeniivesteaccwensceelene savers errdemon(1M) 
CFIC seus aus oneal dani eas eas dusenceceisaneves errfile(4) 
Error FUNCTION ANC .........eceecececeecececees erf(3M) 
error messages from UNIX to ............ conslog(7/) 
ErrOr MESSAGES PEPOM .......ceceeeecseeeeee perror(3C) 
error records from dump errdead ..... errdead(1M) 
error-handling function matherr ....... matherr(3M) 
error-log file format errfile ..............08. errfile(4) 
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terminate the 


process a report of logged 

find spelling 

process a report of logged errors 
the error-logging daemon 

line connection dial 


expression expr 

test condition 

text editor (variant of 

(visual) display editor based on 


reading or lockf provide 
execute a file 
network net 


construct argument list(s) and 
at 

compile and 

uuxat 

L.cmds remote 

set environment for command 
suspend 

prepare 


UNIX-to-UNIX system command 
calls link 
create a new file or rewrite an 


terminate process 

EOT on the other terminal and 
exponential intrinsic function 
power, square root function 
compress and 

conversion ftype 

exp Fortran 

square root function exp 
arguments as an expression 
routines regexp regular 
regular 

evaluate arguments as an 
compile and execute regular 
-errdead 

Fortran 77 compiler 

split 

inter-process communication 


provide drill in number 
data in a machine-independent 
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error-logging daemon errdemon ...... errdemon(1M) 
error-logging daemon errstop .......... errstop(1M) 
error-logging interface err .............06. err(7) 
CIFOlS CIOL cscs cacssvs vunsepsesoteacsdsactetnonsnees errpt(1M) 
SIlOlrS SOON ccdiccccsvcccccvaccttussavavsvsnsssessse spell(1) 
QUE ccsasensseidedisudcsscsestuevaseavereeradvesceseseeas errpt(1M) 
CMrstOP terminate ............ceescssseceenseees errstop(1M) 
establish an out-going terminal ....... dial(3C) 
establish mount table setmnt ........... setmnt(1M) 
evaluate arguments aS AN ............000 expr(1) 
evaluation COMMANGT ...........cecesescsenee test(1) 

ex for casual users) edit ................608 edit(1) 

OX Vi SCFEEN-OFleENted ............ceeeeeeeees vi(1) 
examine system images Crash .......... crash(1M) 
exclusive file regions fOr ..............eseee lockf(2) 
CXOG esssciiuuecn sees satssaustusacesinass seieewinsaere exec(2) 
execute a command on the PCL ....... net(1) 
execute a file CXC 0... eee cescscesceneeee exec(2) 
execute COMMANA XaIGS ........sccsseseees xargs(1) 


execute commands at a later time.... at(1) 
execute regular expression ............... regcmp(3X) 
execute remote command requests .. uuxqt(1M) 


ExeCUutiION COMMANAS ..........ccecscssescene L.cmds(4) 
EXCCUTION ENV: cesccipiasiescctasceccsccoeeente seve env(1) 
execution for interval sleep ............... sleep(3C) 
execution profile monitor ................. monitor(3C) 
execution time profile profil ............... profil(2) 
EXECUTION WUX  ccecescascacesendesdeesgcadezeuasies uux(1) 
exercise link and unlink system ........ link(1M) 
EXISTING ONE Creat ou... ceececeeeesececeeees creat(2) 
exit terminate PrOCeSS ............sscssseeees exit(2S) 

OX Uo encccd acer occas esas enc cesver esc cuveniessianke exit(2) 
OXitSs WHILE ci ciscenceseecdesckreewudusiesseenlee nies write(1) 
EXO: OMAN cs cocsccascccesciceuriacuuecsyecetuisoss exp (3F) 

exp exponential, logarithm, .............. exp(3M) 
EXPaNnd filIES PACK 2.0... eee eeereecnecees pack(1) 
explicit Fortran type .........ceeeseeeeees ftype(3F) 
exponential intrinsic function ........... exp(3F) 
exponential, logarithm, power, ......... exp(3M) 
EXPK SVALUATE ..........cceccecceccsccescesecceees expr(1) 
expression compile and match ......... regexp(5) 
expression compile regcmp .............. regcmp(1) 
EXDIFESSION OXF ccc cecccscsenneoccsteroseascosets expr(1) 
EXPFESSION FEQGCMP ........ceseseeseesecneeees regcmp(3X) 
extract error records from. dump ....... errdead(1M) 
UL ociceavarcaiwensavevseavausteseasnunteuiwieseaceesi £77(1) 

77, ratfor, or efl files fsplit ................ fsplit(1) 
facilities status ipcs report ............... ipcs(1) 
factor a number factor ........... ee eeeee factor(1) 
facts arithmetic ....... ee cece eeeeeee arithmetic(6) 


fashion. sputl long integer ............... sputl(3X) 
fast incremental backup finc ............ finc(1M) 
fast main memory allocator malloc(3X) 
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( fbackup 
ire fbackup make a 
procedure checkall 

generate an JOT 

backup of a file system 
backup of a file system 

close or flush a stream 

file control options 

stream status inquiries 

and statistics for a file system 
cut out selected 

times utime set 

common object 

determine accessibility of a 
tape 

copy 

password/group 

change mode of 

change owner and group of a 
differential 

3-way differential 


) public UNIX-to-UNIX system 

_ format of core image 
_ set and get 
( : umask set and get 
i user crontab 
selected fields of each line of a 

convert and copy a 

make a delta (change) to an SCCS 

close a 

duplicate an open 

returns a 1 if specified 

close close a 

dump selected parts of an object 

print current SCCS 

get group 

get password 

access utmp 

write password 

execute a 

search a 

open a common object 

per-process accounting 

common archive 

error-log 

number entries of a common object 

get a version of a SCCS 


group 


an files filendr 
( file Idfhread read the 
a, file seek to the optional 
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fast tape backup of a file system ...... fbackup(1M) 
fast tape backup of a file system ...... fbackup(8) 


faster file system checking ............0.. checkall(1M) 
POU DOU eco ela cisc tite atedesnseeceaueatecaase abort(3C) 
fbackup make a fast tape ................. fbackup(1M) 
foackup make a fast tape ................. fbackup(8) 
IClOSC oie tse saneiacirah a do bouneneteeasataeieanaes fclose(3S) 
TOIVU a cobe se ceeak cuba ves decode nunei eceatetesecsen pasuaase fentl(5) 
VOTROR obec es siceyaicens saa cecawcavatser veoceasaaveeen ferror(3S) 

ff list file NAMES oo... cece cee sete ewes ff(1M) 

fields of each line of a file cut ........... cut(1) 

file access and modification ............. utime(2) 

file access routines Idfcn .................. Idfcn(4) 

THEA CCESS: ca.chocdvccssvaseaulecveassewereatesesubes’ access(2) 
tHE -ArCNIVEl Tal - decsasrstcccasessieeosceenees tar(1) 

file archives in and out cpio ............. cpio(1) 

file CHECKErS PWCK ..........ccecesceneeeceees pwck(1M) 
TE CNIMNOG ecco resy sce h veri ccacsntedsecesstouies chmod(2) 
TNE CHOWN -exicuvesse sas accehee ees casecenecaesies chown(2) 
file comparator iff oo... eee caer ee diff(1) 

file Comparison iff3 ....... eee e ee diff3(1) 

file CONtrOl FONE oo. eee ceee eee ee eres fentl(2) 

file contro! options fentl .................... fentl(5) 

fIIQ COPY UUtO 20... ececsssscneeeereeteecesees uuto(1) 

TUG CONC. ics coder siewscecuateacssevsortndaudivendieees core(4) 

file creation mask umask ..............006 umask(2) 
file Creation MASK ............cecceceececeewenes umask(2S) 
MUNG SCLONIAD  ecsiilviceuciccdetscusscnceeeeececy crontab(1) 
(HE CUP CUT OUT: acc sad reece Sexis advosincaniee ees cut(1) 
MICRO | shes 2S tees yauauatestaneteampeceaneagiesds dd(1) 

TUG COIL: -wises casucideeeseeovevsenceeocutestaveleuyes delta(1) 

file descriptor close .............. dteasttetess close(2) 

file CESCrIPTOL CUP oo... ee eeceeeeeeeeeeeeeee dup(2) 

file descriptor is a isatty ..................8 isatty(2S) 
WIS ASSCHOLON 4 ccsisiccdscccuseccatsscrarececedans close(2S) 
TUG CUI BD edaetowswecs socaceds dues saueactnesecae es dump(1) 
file editing activity SaCt ..........eeeeeeee. sact(1) 

file Entry GEtOFeNt .......eeceeseeeeeeeees getgrent(3C) 
file entry GEtDWENT ou... eeeeeeeeeeeeeees getpwent(3C) 
THE ONIY GOUT a veeniedieels Hiseveeeiseeess getut(3C) 
file entry PUTPWENT ............cceeeseeeeeeeeeee putpwent(3C) 
THE OXKOCs a asicshe Seas cases cutuahenaxdadssedeewescusees exec(2) 

file for a pattern Grep ou... css eeeeeee eens grep(1) 

file for reading IGOPe)N .............cceeeeeees Idopen(3X) 
file format acct ....... J lesgeuaecerysia uodeseieee acct(4) 

TIC TOMA Al. coasts accaeeseedenesceasateaeeeens ar(4) 

file format Errfile oc eeceececeseeceeeeees errfile(4) 

file function Idiread line ................... ldiread(3X) 
MIO O CL, ge: iacwea vecveaves ict soncsesacaeaceaniasenee get(1) 
TILGCQTOUD! ics chaos eiesd oatauevstiyaaansaepern group(4) 

file header for common object .......... filendr(4) 

file header of a common object ........ Idfhread(3X) 
file header of a common object ........ Idohseek(3X) 
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split a 

issue identification 

header of a member of an archive 
close a common object 

file header of a common object 
of a section of a common object 
file header of a common object 
of a section of a common object 
section header of a common object 
section of a common object 
table entry of a common object 
table entry of a common object 
symbol table of a common object 
number entries in a common object 
link to a 

build special 

Or a special or ordinary 

generate 

make a unique 

file system ff list 

change the format of a text 

print name list of common object 
the null 

find the slot.in the utmp 

identify processes using a 

creat create a new 

password 

files or subsequent lines of one 
more, page 

terminals pg 

reposition a 

move read/write 

Iseek move read/write 

report the current value of a 

print an SCCS 

read from 

lockf provide exclusive 
information for a common object 
remove a delta from an SCCS 
big 

compare two versions of an SCCS 
format of SCCS 

header for a common object 

get 

stat get 

information from a common object 
processes using a file or 
checksum and block count of a 
symbol name for common object 
common object 

daily/weekly UNIX system 
checkall faster 

interactive fsck, dfsck 
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file iNto PieCesS Split ...........ceesceeeeesenees split(1) 
THE ISSO Ci. 55eeclaciceenadsccteentpaeeewcsavavavace issue(4) 
file Idahread read the archive ........... Idahread(3xX) 
TNS TOCIOSS: os csc sciusiascanicesuincwesidevsatesessees Idclose(3X) 
file Idfhread read the ............cesesseeeeees Idfhread(3x) 
file Idlseek line number entries. ......... Idiseek(3X) 
file Idohseek to the optional ............. Idohseek(3X) 
file ldrseek relocation entries ............ Idrseek(3X) 
file Idshread an indexed/named ....... Idshread(3x) 
file Idsseek an indexed/named ......... idsseek(3X) 
file Idtbindex index of a symbol ........ Idtbindex(3x) 
file Idtbread an indexed symbol ....... Idtbread(3X) 
file Idtbseek seek to the ..............ceecees Idtbseek(3x) 
file TINENUM TINE 20... eee cesceeseeeesoneees linenum(4) 
TG MIN ac desscowiedenwasstsaveusceecescsesteasecesvess link(2) 
TUEIIMKMOG css vw vauetueverccnlsterdesenddstavens mknod(iM) 
file mknod make a directory .............. mknod(2) 
file name for terminal ctermid ........... ctermid(3S) 
file NAME MKtEMP 2.2.2... cssceeeccssesenenees mktemp(3C) 
file names and Statistics for a ........... ff(1M) 
FIIQ NEWFOMM 2... cet sccnecccececncccsccceccecs newform(1) 
UGE IIN -recayalccederewtae cca aeaie eset cave sveiects nm(1) 
TCU oc hee esac eee ae sand cevaccocateeuevasezacs null(7) 
file of the current user ttyslot ............ ttyslot(3C) 
file or file structure fuSe@r ............cccceee fuser(1M) 
file or rewrite an existing one ............ creat(2) 
TNE DASSW “ccsssipicts cewwsseescusetessubcesed ances passwd(4) 
file paste same lines of several ......... paste(1) 

_ file perusal filter for crt viewing ......... more(1) 
file perusal filter for soft-copy ........... pg(1) 
file pointer in a stream fseek ............. fseek(3S) 
file pointer IS@@k .............ssssscsscsessssoeees lseek(2) 
THE DOINTCR navientsccccesscasacsussccieiwesecisenses Iseek(2S) 
file pointer tell .........ceccesecesceeeescnecees tell(2S) 
TIESOVS: sncecsacceviesy Succes satessarsuy ide coacsivatws prs(1) 
THE VEO: owccaeicticncescckcnacetvcnssciwissancestexeie read(2) 
file regions for reading OF ...........ccc00 lockf(2) 
file reloc relOCatiOn ............cececcessceesces. reloc(4) 
TIE CINOOL ccaccecvcasconcedescindaudssaeauenecsserene rmdel(1) 
file SCaNMer DFS .......ccccsssscsscescsscnsccecees bfs(1) 
TIS SCOSOIN crs cba cuteccuedieccs acces sxeseeacecs sccsdiff(1) 
THE SCCSING: occes. satesundccaredevanancaceseusaeacet sccsfile(4) 
file scnhdr Section ...........s0c00 Specuzayeuss scnhdr(4) 
file StatUS Stat ....... cc cececsscssceccectesenenes stat(2) 
TUG StAUIS axccuvecsshusctonactaciavectanseusveesccees stat(2S) 
file strip and line number .............c008 strip(1) 
file structure fuser identify ................ fuser(1M) 
TilS-SUID: DIIAE cveseclesecavenececusnatentrdetsaess sum(1) 
file symbol table entry Idgetname ..... Idgetname(3x) 
file symbol table format syms ........... syms(4) 
file system backup filesave .............0. filesave(1M) 
file system checking procedure ......... checkall(1M) 


file system consistency check and .... fsck(1M) 
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( , and interactive fsck, dfsck file system consistency check ........... fsck(8) 
file system debugger fsdb ................. fsdb(1M) 
fsdb_ file system Gebugger .............. eeeeeeoee fsdb(8) 
file names and statistics for a_ file system ff list 0.0.0... ecceee econo es ff(1M) 
construct a _ file system MKfS ............. ce ceeeeceereecenees mkfs(1M) 
mount and dismount file SySteM MOUNT .............. sec seeseee son eees mount(1M) 
mount a_ file SySteM MOUNT .......... ce ceee eee eeeeceeeees mount(2) 
incremental file SySteM restore .............ccececseesceeees restor(1M) 
restor incremental file SysSteM restore ...........cecececececececeees restor(8) 
get file system statistics ustat .......0.. ustat(2) 
ustat get file system StatiStiCS .............ceeessseeees ustat(2S) 
mounted file system table mnttab .................... mnttab(4) 
unmount a_ file SySteM UMOUNE ............ccccscecesceenes umount(2) 
MouNt 2 _ fil SYSTEM ........... ce ceeeteccececsecssecereeees mount(2S) 
unmount 2 _ fil€ SYStAM 20... e cee ceeeeceeceeceeees umount(2S) 
make a fast tape backup of a_ file system fbackup ....... eee fobackup(1M) 
time dcopy copy file systems for optimal access. ......... dcopy(1M) 
checklist list of file systems processed by fsck .......... checklist(4) 
voilcopy copy file systems with label checking ........ volcopy(1M) 
deliver the last part of a file tail... ececeseeeeeecenceceeeceeee tail(1) 
create a temporary file tMpfile .......... eee teceeceneeeeeeeeeceees tmpfile(3S) 
create a name for a temporary _ file tMPNAM 2.0... cee tee ecncsecsecseccenes tmpnam(3S) 
and modification times of a_ file touch update access ................05 touch(1) 
uucp system uucico file transport program for ..............60 uUuCcICO 
walk a _ file tree ftW oo... cic ececescsececceceeeneens ftw(3C) 
ies determine file type file 2.0... cceccceseneceesncecceens file(1) 
( undo a previous get of an SCCS file Unget 20... setesccsssscceeereceseees unget(1) 
al report repeated lines in a file UNI ..............csseessessssssssceececenereeners uniq(1) 
validate SCCS file Val oo... eee ececceccnncseesseececceseees val(1) 
write ON a file Write 2.0... ceccsecetenctencsccerceecenes write(2) 
creat Create a NEW SPECial fil@ ....... ee teeesrececcssoeesssecssscescerecssvens creat(2S) 
determine file type file 20... ee cseccccenceceecsenerccecensesceenens file(1) 
mknod make a Special file 1... teccecsecsseceseccesscenensesessnecees mknod(2S) 
FEaG TAG WOM . ‘TS sisececusivvsacceueseocavssscewassaccasuedeusseceannes read(2S) 
WHITE OM STNG: discs tciccvcwestenecseiuedudsataensedeacevossisetieed write(2S) 
format of compiled term file term .......... ec eceecseceeceseesesaneeceecees term (4) 
and print process accounting file(S) ACCtCOM SEAICH ..........esseeeceenees acctcom(1) 
set file-creation mode mask umask ........ umask(1) 
header for common object files filehdr file 0.0... eee eecreeceneecceeeeees filendr(4) 
Cataio COWNlOad Program  filOS ........ cc ec csseeceecceseceeeecessescaeeceeeesers dataio(1M) 
merge or add total accounting fileS ACCIMErG ........ ee tee cet eccenceteceene acctmerg(1M) 
create and administer SCCS files AGMIN oo... tesceectecneceerees admin(1) 
concatenate and print fil€S Cat oo... cee ceceenreseeeeesceeneees cat(1) 
COMPAre twO_ FIIES CTP ........ ese eecteceeccereseceeceeceoeeeees cmp(1) 
reject lines common to two sorted files comm SeleCt OF ...........cccceecsesceees comm(1) 
COPY, lINK OF MOVE fFIIES CP oo... eceeeeceeceesceenecececceeensersetees cp(1) 
mark differences between files ifffmk ...............sscsseccessecssveeescnsrens diffmk(1) 
file header for common object files filehdr ............ecseessceeeseecceneecens filehdr(4) 
recover files from a backup tape frec ............ frec(1M) 
format specification in text fileS fSPEC ou... eeeccccessseccseesseseesneneees fspec(4) 
Get split £77, ratfor, or efl fileS fSplit. 0.0... ccsescceessersesecessceencs fsplit(1) 
( a string, format of graphical files gps graphical primitive ............. gps(4) 
_, install object files in binary directories cpset ......... cpset(1M) 
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link editor for common object 
remove 

merge same lines of several 
compress and expand 

print 

section sizes of common object 
sort and/or merge 

identify SCCS 

archive format convert archive 
UNIX system file system backup 
more, page file perusal 

file perusal 

select terminal 

line numbering 


graphical device routines and 
graphics 
fast incremental backup 


object library lorder 


an object, or other 
the current user ttyslot 
find files 


ecvt convert 

manipulate parts of 
absolute value functions floor 
generate C 

close or 

open a stream 

create a new process 
per-process accounting file 
common archive file 
common archive 

error-log file 

nroff or troff eqn 


change the 


term 


graphical primitive string, 


nroff 

files fspec 

common object file symbol table 
tbl 

sroff 

utmp and wtmp entry 
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[Cero [IRSA sere pe Be Per Id(1) / | 

files OF GireCtOrieS FM .........ecececeeeeeees rm(1) Mea tebt 

files or subsequent lines of one ........ paste(1) 

TIES (DAGK iueticchdevacticesaaerateerimewts pack(1) 

WIGS DM icc crcoutmeascscaccssaenekeconevetareawontas pr(1) 

THES SIZE ONIN E apccssccicncidecececanecersenectionss size(1) 

WES SOM ccetsietccccciceesidencdeesteligieereetiars sort(1) 

TICS WIA sci iicrcdddesieedvcsveceicaetemcenstocnes what(1) 

NGS Sic ccewcrareiivenastenden scare eid aioe aoresbeees arcv(1) 

filesave daily/Weekly .............ccccesceeevee filesave(1M) 

filter for Crt VIEWING 20... ceeceeeseewe sees more(1) 

filter for soft-copy terminals pg ........ pg(1) 

ILET GROG: oii ics Gucersvsticeetecectcsenveventees greek(1) 

UUTGT Oe giaescctucctete acters seececuaeesneeseeeess ni(1) 

filter reverse line-feeds col ................ col(1) 

WHETS:Q GOV ds:cnecriaccousss shal evtenwarsusvertex gdev(1) 

HMCKS 1DIOt: cciscssccteevsavessceaveanstaavecnsuvedsss tplot(1) 

WING cers ccciciecciis snasedosauendoacectuteensecedvabetues finc(1M) 

find hyphenated words hyphen ........ hyphen(1) 

find name of a terminal ttyname ....... ttyname(3C) 

find ordering relation for an .............. lorder(1) 

find spelling errors spell ...............c008 spell(1) 

find the printable strings in ............... strings(1) 

find the slot in the utmp file of .......... ttyslot(3C) 

TIVO) ac saile wines dusstasaeecksvasees ts cucaurewaSexoersics find(1) 

float and double routines ..............0.. float(2S) yar, 

floating-point number to string ......... ecvt(3C) 

floating-point numbers frexp ............ frexp(3S) a, 

floor, ceiling, remainder, ...............06 floor(3M) 

Flow Graph CHOW ou... ceccesseeesseeeeeceeee cflow(1) 

flush a Stream fClOSE 2... eeeeee en ceees fclose(3S) 

TOD ON Gicatadscchdtvnsvovecentccascitssaxtesaceowstaks fopen(3S) 

TORK. cdacsoarne tude rseatesdiediesiwevens: Ciadensege fork(2) 

TOPMAACCE sesssiceceineccrsvaterecsdaceeeeeer ions acct(4) 

TOUT AN sewssceisicioneiecdeecace sea sdesecsmaevsenss ar(4) 

format arcv archive fileS ............. cece arcv(1) 

TOLM AL Chile we veccscv dices caviestenasoueetecones errfile(4) 

format mathematical text for ............ eqn(1) 

format of SCCS file sccsfile ............... sccsfile(4) 

format of a text file newform ............. newform(1) 

format of an i-node inode .................. inode(4) 

format of compiled term file .............. term (4) 

format of core image file core ........... core(4) 

format of cpio archive cpio .............. cpio(4) 

format of directories dir ........... eee dir(4) 

format of graphical files gps ............. gps(4) 

format of system volume fs ............... fs(4) 

format or typeset text 00... eee eeeeee nroff(1) 

format specification in text .............. fspec(4) 

TONIMAT SVMS cscs ccstscncwdarecuseectevssgeueasncese syms(4) 

format tables for nroff or troff ........... tbl(1) 

TOP M ATION cancsascanessecssesnasscansensssestceeae's sroff(1) ie 

TOPIMAS UTM D> weccsicckeveveecenssteeeasedienaess. utmp(4) LL | 
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argument list vprintf print 

print 

dformat disk 

mptx the macro package for 
troff text 

mm the MM macro package for 
OSDD adapter macro package for 
man macros for 

binary input/output 

recover files from a backup tape 
report number of 

parts of floating-point numbers 
format of system volume 

list of file systems processed by 
check and interactive repair 
check and interactive repair 


file system debugger 

a file pointer in a stream 

specification in text files 

split f77, ratfor, or efl files 

controller 

walk a file tree 

=: explicit Fortran type conversion 
aa Fortran arcsine intrinsic 
Fortran arccosine intrinsic 

Fortran integer part intrinsic 
function error 

Fortran arctangert intrinsic 
Fortran arctangent intrinsic 
complex conjugate intrinsic 
hyperbolic cosine intrinsic 
precision product intrinsic 
function and complementary error 
Fortran exponential intrinsic 
logarithm, power, Square root 
log gamma 

Euclidean distance 

entries of a common object file 
natural logarithm intrinsic 
common logarithm intrinsic 
error-handling 

profile within a 

transfer-of-sign intrinsic 
Fortran sine intrinsic 

Fortran hyperbolic sine intrinsic 
Fortran square root intrinsic 
Fortran tangent intrinsic 
hyperbolic tangent intrinsic 
math 

Fortran bitwise boolean 

Fortran cosine intrinsic 
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formatted input SCANF .......eeesceeeeeee scanf(3S) 
formatted output of a varargs .......... vprintf(3S) 
formatted output printf 2.0... eee eeeee printf(3S) 
TOM AUC sous i scccsseiesscecvesstcsvodezeeaegiatesnns dformat(8) 
formatting a permuted index ............ mptx(5) 
formatting and typesetting ................ troff(1) 
formatting COCUMENES ...........cseceeseeeee mm(5) 
formatting documents mosd the ....... mosd(5) 
formatting entries in this manual ...... man(5) 
WOO coesslceuusaced edensceccuscertetvenseiiesacs fread(3S) 
PCC os dass sBucica seacosuedearetoueeeuddcbuecsaekeveweseueds frec(1M) 
free disk DIOCKS Cf ............sccscceesceeeeees df(1M) 
frexp Manipulate ........... cc ccseessccesesees frexp(3S) 
ES ecsereuceenssvauoassd caneseucsusewsuansscoceusetnesenees fs(4) 

ISCO CNECKIISE: gxccccracectccyecineceeisetecesasees checklist(4) 


fsck, dfsck file system consistency ... fsck(8) 
fsck, dfsck file system consistency ... fsck(1M) 


fsdb file system debugger ................. fsdb(8) 
VSO seca oct weataaeatiscecccessncicvavesenceatese eae fsdb(1M) 
FSEEK TEPOSITION 2.0.0... cc eeeceeseweeeeeeeceees fseek(3S) 
FSDOC TOMA svsssuessnsver soassosewesennsveccutens fspec(4) 
TSUN. wescacatutive sis cetacens wincedeseuedesdetonsecatecs fsplit(1) 
ft IMSP streaming cartridge .............. ft(7) 
IEW? 2uiadesctcciedvanchecselseau neues testesueasesessbeess ftw(3C) 
WY DO osscastecsveectenesiuescanstascueese users caive ftype(3F) 
TUICUG ASIN: coisa vescessiecccvensspeccaaseaacetees asin(3F) 
TUNCUON SA COS® (kc ne teeGaieeevsiccdccturtareeses acos(3F) 
TUN CUON AINE scccnaitsedecceaccecuseeectectzoassess aint(3F) 
function and complementary error ... erf(3M) 
TUNCUON- ALAN sescsas ci vaks cescciecdeveeeccsoetses atan(3F) 
TUR CUONT ALANS: sacaicccbscconstiescdinintudeesvins atan2(3F) 
function conjg Fortran ................ceeeee conjg(3F) 
function cosh Fortran ......... Bola piaeits cosh(3F) 
function Gprod double .............scceseees dprod(3F) 
TUNCHOMN CFT CEION  oicestaccecessteuaeiscideseees erf(3M) 
TUNICUOMI NCD wines sancawsbasnerserencieccstversedies exp(3F) 
function exp exponential, ..............06. exp(3M) 
TUNCUOR GAMMA cass ccccnevasivecdedssecesaccase gamma(3M) 
TUN CHON, NYDOU sc hciiwc tive sesavescanesspeseass hypot(3M) 
function Idiread line number ............ Idiread(3X) 
FUNCTION LOG FOrtran ...........ccceceseneeeees log(3F) 
function 1log10 Fortran ............. ceseseee log10(3F) 
TUMCTION NANCE ic cecsscccrccsesvslosscevsenss matherr(3M) 
TUNGCUON DION sess stecussetewssscesscesanasewecsives prof(5) 
fUNCTION SIGN FOrtran 0... eeeseeeeesees sign(3F) 
TUTCTONISIN cusovcee aeusavesertudeadtevetaceecstes sin(3F) 
TONCUON SIAN: sancseeseocuceslesecheseweseccesaes sinh(3F) 
TUNCUON SOE, score ttanteineeeretneseses sqrt(3F) 
TUN CUOI AAR: Snlsseshecoucssacatiandaennteneatiasss tan(3F) 
FUNCTION taNh FOrtran ..........ccccsceeeeeees tanh(8F) 
functions and constants math .......... math(5) 
TUNCUONS DOO! ccessddasecedseeeceiccasiniscevest bool(3F) 
TUN CUIONS COS: secesssessavecsdosotenectenienbecede cos(3F) 
-21- April 1985 


PERMUTED INDEX 


positive difference intrinsic 
remainder, absolute value 
Fortran maximum-value 
Fortran minimum-value 
Fortran remaindering intrinsic 
terminals 300 handle special 
2621-series handle special 
terminal 450 handle special 
Fortran nearest integer 
hyperbolic 

string comparision intrinsic 
trigonometric 

using a file or file structure 
guessing 

the 

the 

the 

the 

log gamma function 

device routines and filters 
graphic editor 

tty 


cross-reference cxref 


user ID diskusg diskusg 


ctermid 

ncheck 

lexical tasks lex 

pseudo-random numbers drand48 
simple random-number 

random number 


get 


user Cuserid 
stream getc 
nlist 


stat 
uStat 
ustat 


uname 
vector getopt 
getpwent 
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TUNCTIONS GIND * dscccseesisciicctsedcesjueeedeseees 
functions floor floor, ceiling, ............. 
TURCHONS Maxis ease 
TINCHORS IN: sicdecucro uteri esesceventesendes 


TUNCTONS FOUN ccciiessisccsdesscenacasonces oon 
FUNCTIONS SIN 00... cceeceeecsenccrssceeseoees 
FUNCTIONS SIPC ........cescesccssccsecveceeces 
TUN CUONS T61G ats owscdvestacuccdseisenetorececuars 
fuser identify processes. ..............c0008 
GAMO (100) se scescscavinscerecboishegicwesiseaatasess 
game of backgammon back ............. 
game of black jack Dj ........eeeceeees 
Game Of CrapPS Crap ...........eceseseeeeees 
game of hunt-the-wumpus wump .... 
CAINS cid scasesesve lenge awnadisasctaceetancsocuned 
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get path-name of current .................. getcwd(3C) 
Get PlOCeSS ND! vecicceededcsewsivensenteeiensaes getpid(2S) 
get process and child process .......... times(2) 
get process, process group, and ...... getpid(2) 
get real and effective user, .............0 getuid(2S) 
get real user, effective user, .............. getuid(2) 
get set of semaphores semcet .......... semget(2) 
get shared memory segment ............. shmget(2) 
get terminal characterisitcs .............. gtty(2S) 
get the name of the terminal ............. tty(1) 
Get tiMe thMES 00... eecteeceneeoesene ones time(2) 
GETING cine carcnrcuervcesseicectesieolexvswioneess time(2S) 
QelArG(GtUlA: ives sieve ecesenieversernscoeacs getarc(3F) 
getargv display a program name ..... getargv(2S) 
GELS Get ierccssvereheteseucaiialas Biecnaese getc(3S) 
getcwd get path-name ...........ccccseceee getcwd(3C) 
CSTE di celaccecticcreaeiteiseic telecine es: getenv(3C) 
GETENV FOTUIN .........cesssceevesccescessensceees getenv(3F) 
CCIGI ONG aces diisesteacsewiscsnsoniacescesasoauoneoass getgrent(3C) 
GOTO ins sewed sveceas overs civaseevesecavevesscetense getlogin(3C) 
CElODI... wen sevscpvitinecereacucecanateesscecvesvensouss getopt(1) 
getopt get OPtion ............cccccssseeereenes getopt(3C) 
GOD ASS. S56 sec pae raed ce Niscdccadacnceecndens getpass(3C) 
getpid get process ID ou... eesseeeees getpid(2S) 
getpid get process, process. ............. getpid(2) 
GOLOW, crssssvceustvae- cotesteosccenccnes cevsscasetiests getpw(3C) 
GOtOWENE seivieiccesvsccivareaiawcesaccieesvexensses getpwent(3C) 
GUS: sssccu sic casenscasctwapeassesereentensccevacevousades gets(3S) 
getty to a remote terminal ct ............. ct(1) 
gettydefs speed ANd ..........eecesecesscees gettydefs(4) 
getuid get real and effective .............. getuid(2S) 
getuid effective user, real ..............ee getuid(2) 
JOTI aa sepsaics ost yceetscssevenltnecieessteanedsetacsss getut(3C) 
COLO cose aren see see wecruvccuavsss suckeeeseedaveaseeeee’ setjmp(3C) 
gps graphical primitive ...........ceeseeee gps(4) 
GRAD CHOW so oeceucousevaniesvocivoutdascecveietne cflow(1) 
OCADN SAG. cisacesre costes teres entwoncevveses cee sag(1) 
GLEAN ceseceeciiascsveweceevsiisvenesteccdsecusuecouuaes graph(1) 
graphic editOr Ged 1... eeeeeeewseseeenesees ged(1) 
graphical and numerical commands graphics(1) 
graphical commands stat .............006 stat(1) 
graphical device routines and .......... gdev(1) 
graphical files gps graphical ............ gps(4) 
graphical table of contents ............... toc(1) 
graphical utilities gutil ...... eee gutil(1) 
graphics filters tplot ........ ce eeeeesee ees tplot(1) 
graphics interface plot ..........eeeeeeeee plot(4) 
graphics interface subroutines ......... plot(3X) 
GrapNiCS ACCESS ........cccssccseceeesseeeeeeees graphics(1) 
OrAPDNS INV \cstcovsecucevieczeteslsenccagetd acces mv(/) 
Gl Chasen ricevs ia cinceyncesueeussacs csiaeiacnabeodk greek(1) 
GLCD* su cussane sits eukcasoretndccancetexcassaureneaners grep(1) 
Group ID SeCtPOIp ..........ceccensceeccnecneees setpgrp(2) 
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ener getuid(2S) co 
group ID’s getuid effective ................ getuid(2) tad 
group IDs and names id .............-..06 id(1) 
Group IDS SetUI .0.... eet eee eee eeeenees setuid(2) 
GQFOUD CHOWN -sivssiiesaloesteeicetactesietees: chown(1) 
group file entry getgrent ................000 getgrent(3C) 
QrOUup: TIO Group) svccecscsncsvssscenateavecczecs group(4) 
GrOUD NOW! -Aessdececiscccwvensadoeaeniases ver newgrp(1) 
group Of a file CHOWN. ........... ec ceseceeeee chown(2) 
group of processes Kill ..................006 kill(2) 
GEOUD> coscsiectatssaccveccadiavussoaneeseseosantevents group(4) 
group, and effective group ID’s ........ getuid(2) 
group, and parent process IDs .......... getpid(2) 
groups of programs make ................. make(1) 
Qtty get terminal ......... ee sececeseeeneee gtty(2S) 
guess the word hangman ................. hangman(6) 
GUESSING GAME MOO ........ccssescssnseseeees moo(6) 
OUI ess carevtcuananceencas se ceucuevesusebiycusceiesuaeas gutil(1) 
handle special functions of DASI ..... 300(1) 
handle special functions of HP ......... hp(1) 
handle special functions of the ........ 450(1) 
handle variable argument list ........... varargs(5) 
handling and optimization package curses(3X) 
WAN OMAN) cc siicecesavsnesecdtaavaneovesssecseaterses hangman(6) 
NANGUPS ANA, QUES ....... ee eee tec eeeeeee nohup(1) — 
hash search tables hsearch ............. hsearch(3C) a 
header for a common object file ....... scnhdr(4) ae 
header for common object files ........ filehdr(4) - 
header of a common object file ........ Idfhread(3x) 
header of a common object file ........ Iidohseek(3X) 
header of a common object file ........ Idshread(3xX) 
header of a member of an archive ... |ldahread(3X) 
NGI: ccsssedesheaetecusnetuatiewssaseosbsucveniventdagies help(8) 
GID: cxdaus des cacchucaasevewebucidedueccenacwvasexcncoegs help(1) 
hp handle special functions of ......... hp(1) 
PISCAICH 2 iadssunccccevtucsvccsdoncteeusesocesiesuners hsearch(3C) 
hunt-the-wuUMPUS WUMDP .........ccceeeeees wump(6) 
hyperbolic cosine intrinSic .............0 cosh (3F) 
hyperbolic functions SINN ...........e. sinh(3M) 
hyperbolic Sine intrinSiC ............cceesee sinh(3F) 
hyperbolic tangent intrinsic .............. tanh(3F) 
hyphen .........066 sab sila Netuandednuaeucucesuaseunes hyphen(1) 
NY DOU citieciacsantecitucdecstesdessuctietacedbececsiasd hypot(3M) 
PAR OC VAL OC caceievecselenieseistavensiemie acon largc(3F) 
I=NOOE CIN iecisxescevedecncchavasassecenccteresccens clri(1M) 
I-NOGE INOGE .cc.cccecscccacccsccccscessocasccncses inode(4) 
I-NUMDErS NCHECK ........cecececececenseeecees ncheck(1M) 
icp Intelligent Communications. ........ icp(7) 
icpdmp dump contents of an ........... icpdmp(1M) 


id ipcrm remove a message queue, . ipcrm(1) 


GOD S ee instent atten ete id(1) " 

identification file iSSUC «....cscsssscscceesee issue(4) a, 

identify SCCS files what ........... eee what(1) ed 
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identify processes using a file ........... fuser(1M) 
IMAGE TIS COLE so ccccsscescevesisvcseveseseswasees core(4) 
IMage COPy Of a tAPES ow... sserescceeceoes copytape(1) 
COFE MEMOTY MEM .......sccseccececsscecnceess mem(7) 
IMIAGES ChASN cecccccsascceecbadeevesscavsencsusons crash(1M) 
imaginary part of complex .............+.. aimag(3F) 
immune to hangups and quits ......... nohup(1) 
imsp Intelligent Mass Storage .......... imsp(7) 
incremental backup fiNC ...............0008 finc(1M) 
incremental dump tape format .......... dump(4) 
incremental file system restore .......... restor(1M) 
incremental file system restore .......... restor(8) 
independent operation routines ....... termlib(3C) 
index of a symbol table entry of ....... Idtbindex(3X) 
WOOK OU sc scdiswostnctacdevavevasstacee sousccextucs ptx(1) 

INdEX MPtxX the MACIO oo... cccseeseescees mptx(5) 
HIGOX TOTUIN: is ececsuetaccectcidacsccaascensdenssaes index(3F) 
indexed symbol table entry of a ....... idtbread(3X) 
indexed/named section header of .... Idshread(3xX) 
indexed/named section of a ............. Idsseek(3X) 


information for a common object ..... reloc(4) 
information from a common object .. strip(1) 


INforMatiONn IPStat .......... ces eeecceseeeees Ipstat(1) 
Scena taeda stuaeeavesec se uersae eect eceeceaseauwseceuseeees init(1M) 
INITIALIZATION IMIt ....... cc cecceccseceecseeereess init(1M) 
initialization shell scripts bre ............ brc(1M) 
initiate pipe to/from a process. .......... popen(3S) 
HIT: eceuecco cons ece Sicseiig eabiasncescese ees teaes inittab(4) 
HVOOC dec endise ooidssankuacicdesaveeecasdessicauiunsi inode(4) 
INDUt SCANF saisdesscwcadevsnceusdasioonseserceners scanf(3S) 
INPut StreEAM UNGETC .........-cecssecsseeeeees ungetc(3S) 
input/output fread ........... eee eee eens fread(3S) 
input/output package stdio .............. stdio(3S) 
INQUITICS TOLCOP -cchecsccecaveccutiessesecsessensees ferror(3S) 
inquiry and job control uustat .......... uustat(1) 
install object files in binary ............... cpset(1M) 
HASTONL: wccovsvccsencusipeedsshacdiven Gerbuneeseeteets install(1M) 
integer absolute value abs ................ abs(3C) 
integer and base-64 ASCII string ..... a641(3C) 
INtEGEr Mata IN a ....csrerscssecrecceseeseecesces sputl(3X) 
integer fUNCTIONS FOUNT .............escceeee round(3F) 
integer part intrinsic function ........... aint(3F) 
TIEQEF SUTOl ecco cect oicadeescieuazescexacteials strtol(3C) 
integers and long integers IStol ........ I3tol(3C) 
inter-process communication ........... ipcs(1) 
interactive message processing ....... mailx(1) 
interactive repair FSCK ..........eeseeeeeees fsck(8) 
interactive repair fsck, dfsck ............. fsck(1M) 
(TCT ACO oe acd eciacebucs onsen nedocdnacengedsoends tty(7) 
WTC ACE Cll seiccccocsetantssceetitessudedetwudeuest err(/) 
FFITCHI ACE: DIOL 255 secesciersivlivacdsnasevereatens plot(4) 
interface subroutines plot ..............06. plot(3X) 
IN TOTL A CO sect basa ictecvccntee cei vcentastveantenencs pp(/) 
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interpolate smooth curve spline ....... spline(1) 
interpret ASA carriage control .......... asa(1) 

INTE DICIER -SINO: sciessidiclectecsanteearticsnvess sno(1) 
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interprocess channel pipe ................ pipe(2) 
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interval sleep .......... caicuide souavaoucandacerenee sleep(1) 
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INTTINSIC FUNCTION AINt .........cccccceccecceee aint(3F) 
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INtrINSIC FUNCTION CONJG .........cescereseees conjg(3F) 
INTrINSIC FUNCTION COSN ........cececcesceene cosh(3F) 
intrinsic fuNCtiON Aprod ..........cesseeeeee dprod(3F) 
INTFINSIC FUNCTION EXP .......cceecesceceeseees exp(3F) 
INtFINSIC FUNCTION 10G .........ecsscenceceeees 10g(3F) 
intrinsic fUNCtION 10G10 ..........ceceeeeeee 10g 10(3F) 
INTFINSIC FUNCTION SIGN ........ccceeceesceeees sign(3F) 
INTFINSIC FUNCTION SIN .........ccceececesenceee sin(3F) 
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INTFINSIC FUNCTION SCP ...........cceceeeeeeees sqrt(3F) 
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FANQU AGS. tice ne acascccans Soc nce eeatensaviabed troff(5) 

large banner on printer ................c0e0 bbanner(1) 
PAtCM NMG FAL, sccvecesatccacstaccnceecdessentnaverts at(1) 

IO) NK eaniieheeeecnscee eke dedenedieeest Id(1) 
Idahread read the archive header .... Idahread(3X) 
HO CIOSS: eerste ce weccva een aeiuatacias econ Idclose(3X) 
[AtCN COMMON: cccdsccceseiaensiiasees Idfcn(4) 
Idfhread read the file .......... eee eee ees Idfhread(3xX) 
Idgetname symbol name for common Idgetname(3Xx) 
Idlread line number entries ............... Idlread(3X) 
Idiseek line number entries of ........... Idiseek(3X) 
idohseek to the optional file ............. Idohseek(3X) 
IDOPON SO DONN scasncacecusdenGuscstcuestocdeccrtenehe Idopen(3X) 
Idrseek to relocation entries of ......... Idrseek(3X) 
Idshread indexed/named section ..... Idshread(3X) 
Idsseek to an indexed/namecd .......... idsseek(3X) 
Idtbindex of a symbol table .............. Idtbindex(3X) 


Idtbread an indexed symbol table .... Idtbread(3X) 


idtbseek seek to the symbol ............. Idtbseek(3X) 
LOL, .ocessieiencussensscaten weatsaiauiedeee meta at len(3F) 
letter from argument vector ...........06 getopt(3C) 
lexical taSKS 1OX ....... ec ccececscescecscecseeees lex(1) 
library lorder find ............ccceesececececeees lorder(1) 
library maintainer for portable .......... ar(1) 
HIDrary MAINTAINED 2... ccecesececsccnceees bar(1) 
PVITS UNTIL: SeveeieceSistsssesstececnasxceesaseeees ulimit(2) 
line CONNECTION ial ............ccceeccesceeeee dial(3C) 
NVIG TING) cseissctieetaxsectoacedscxsnastevencelestieees line(1) 
line number entries in a common ..... linenum(4) 
line number entries of a commoon ..... Idlread(3X) 
line number entries of a section ....... Idiseek(3X) 
line number information from a ........ strip(1) 
line numbering filter NI oo... cece ee ni(1) 
HME Ot ATE CUT oecececdcasceaelscareeesceaevecces cut(1) 
(Gs DIINTOE 10: is wscccataceshcsascuciesiesceedooees [p(1) 
HVS one iewe el oucanantasteesaadswincadeaeustevcencseceees line(1) 
LINC-1ECUS: CON is cek dacecixceeaianidenvivcewseiexees col(1) 
linear search and update Isearch ..... lsearch(8C) 
linenum ine NUMBE ........ ee eeec eee eee linenum(4) 
lines common to two sorted files ...... comm(1) 
HINES IN A FI UNIG .........ceeeeeseeeeeceteecees uniq(1) 
lines of several fileS OF ......... eee eeee eee paste(1) 
link and unlink system calls link ....... link(1M) 
link devices, CONNECTION .............c00000 L-devices(4) 
link editor for common object ........... ld(1) 
link editor Output a.0ut oo... eee a.out(4) 
link OF MOVE FIIES CP oo... ceeeeeecseceeeeee cp(1) 
HMK, SYSIOINS: sscwveccesccacserevesevesedudsctanssess L.sys(4) 
TELL pccasak Vas sas snedniaesk udassccuoseasua ree @eveswenvats link(2) 
LINK QXELCISE ......ccccccecescncccceccsccssesececses link(1M) 
POV pesearsetueslavecs eawasekoteessauseaccteutocmuaee lint(1) 
list contents of directories ...............08 Is(8) 
list contents of directory Is ................ Is(1) 

-2/- April 1985 


PERMUTED INDEX 
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get entries from name 

print name 
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fsck checklist 

handle variable argument 
output of a varargs argument 
construct argument 

macref produce cross-reference 


copy, link or move files 


index return 

ist 

memory plock 

regions for reading or writing 


logarithm intrinsic function 
logarithm intrinsic function 
Fortran natural 

function exp exponential, 
process a report of 
configure 

configure 

get 

get 

get character 

return 

change 

setting up an environment at 
setting up an environment at 
sign on 

get login name 

return login name of user 
setjmp, 

relation for an object library 
run a command at 

requests to an LP line printer 
configure the LP spooling system 
resume printing 

start/stop LP request scheduler 
configure the 

print LP status information 
directories 

list contents of directory 
linear search and update 
pointer 

move read/write file pointer 


macro processor 
access long integer data in a 


listing of macro files 
permuted index mptx the 
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list file names and statistics .............. ff(1M) 
HSUINISU cits c.ccucevcausaussetescaseuesteexeoeoucnves nlist(3C) 
list of common object file nm ............ nm(1) 
list Of dialup GeVICES .............cceeeeseeeee dialups(4) 
list of file systems processed by ....... checklist(4) 
NSU VAN AIGS vec. cssccsascciesccwnssecediveuteusicsees varargs(5) 
list vprintf print formatted ................. vprintf(3S) 
list(S) and execute command ............ xargs(1) 
listing Of MACIO fFIIES 2... ee eeeeeeeeees macref(1) 
LOD UNV oeseeyedecescp okcuncctnassectceesoudesaveess cp(1) 
location of Fortran substring ............ index(3F) 
locations in program eENd .............ee0 end(3C) 
lock process, text, or data in ........... plock(2) 
lockf provide exclusive file ................ lockf(2) 
log gamma function gamma ............. gamma(3M) 
log in to a new group newg/p .......... newgrp(1) 
log Fortran natural ...........eessesseseeee log(3F) 
10g10 Fortran COMMON ............ceeeeeee 10g 10(3F) 
logarithm intrinsic function log ........ log(3F) 
logarithm, power, Square root .......... exp(3M) 
IOGGE EFrOrs CF Pt 20... ce ceee seen eeeneees errpt(1M) 
lOGICAl GISKS: csscsdeccesssacevesasteocensadecsavees dconfig(1M) 
IOGIC AN GISKS <cceces ties ceatenouentextteeceseesens dconfig(8) 
login Name GetlOGiN ...........cseceeessseeees getlogin(3C) 
IOGIN NAME lOGNAME ..........eeeeseesseeeees logname(1) 
login name of the user cuserid ......... cuserid(3S) 
login name of user logname .............. logname(3Xx) 
login paSSword PaSSwG .............eeeseee passwd(1) 
lOGIN time Profile ..............cceeeeeeseeseeeees profile(4) 
lOGIN time Profile ote eee eens profile(5) 
LOGIN: cxstesvccdeicbca:cvciseteasebasewdvuceberseeasesans login(1) 
JOG IVAING <ooetecucciecovssiea iareuewsseecus steeseceees logname(1) 
LOG ING eciseseserceceveeseutseesiersccuawéapenwccaue logname(3x) 
longjmp non-local Goto ...........scseeeee setimp(3C) 
lorder find OFdering ..........ceesecceesseeeees lorder(1) 
IOW PFIOFity MICS ...........cscceeceeceeeeseoense nice(1) 
ID SONG/ CANCE wissiviccssoissessanersdoatccsess Ip(1) 
TD ACTIN: anvsicascctsiewasenscccstnasinceiiaietecnesnans {jpadmin(1M) 
Iphold postpone printing, ............0. Iphold(1) 
lpsched, Ipshut, IPMOvVE .........eeeeeee lpsched(1M) 
LP spooling system Ipadmin ............. lpadmin(1M) 
Ipstat ...... i a pateween saa raNawaeadacesaasauietantanetes Ipstat(1) 
is list contents of .............. bed Badhicate Sats Is(8) 
VS xechretisutdcwcdiccss tdetansetecscideucaecuantreinenites Is(1) 
ISCANCH Acasawrslideccinececseriwsecervansyseesiseraes Isearch(3C) 
Iseek move read/write file ..............e00 lseek(2S) 
ISB OK eccsecuhsncsadvadette das csesucnsauencateevomiaees Iseek(2) 
Ist locations in program end ............ end(3C) 
PUVA ea abeweoss teh ce wa Uoanarte deta scecadsedte es ieeteberes m4(1) 
machine-dependent values values ... values(5) 
machine-independent fashion. ......... sputl(3X) 
macref produce cross-reference ....... macref(1) 
macro package for formatting a....... mptx(5) 
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main memory allocator 
fast main memory allocator 
tsearch 


a common object file function 
floating-point numbers frexp 
print entries in this 


diffmk 

set file-creation mode 

set and get file creation 
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regular expression compile and 
math functions and constants 
error-handling function 

Fortran 

generate a 

return Fortran time accounting 
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read the archive header of a 
main 

fast main 

ramdisk 
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queue, semaphore set or shared 
core 


shared 
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macro package for formatting .......... mm(5) 
macro package for formatting .......... mosd(5) 
macro package for making view ...... mv(7) 
macro package for typesetting ......... mv(5) 
MACFO PrOCeSSOr M4 .......eceeeeseseeeeeeees m4(1) 
macros for formatting entries ........... man(5) 
mail to users or read mail mail ......... mail(1) 
mail /encode/decode @ ...............c0e0es uuencode(1c) 
MaIIX INTEFACTIVE .........cccecceeeseececeeee rene mailx(1) 
main memory allocator malloc ......... malloc(3C) 
main memory allocator malloc ......... malloc(3X) 
maintain, update, and ............. eee make(1) 
maintainer for portable archives ...... ar(1) 
make a delta (change) to an ............. delta(1) 
make a directory mkdir ..................... mkdir(1) 
make a directory or a special ........... mknod(2) 
make a Special file ........ 2... eee cteeee eens mknod(2S) 
make a unique file name mktemp ..... mktemp(3C) 
make an IMAGE COPY ........cceeeeeeeeeeeees copytape(1) 
COTE MEMOTY MEM ......... cee ccececsceceeeeees mem(7/) 
IMAGES Clash cescieccussstnusiscapsesiacetenceees crash(1M) 
make posters banner .................-es08e banner(1) 
IMAK CK OY. seve ast esata ese tuesaeerncat ere tees makekey(1) 
MakING VIEW Graphs ........ ec ceeeseeeeeee wees mv(7) 
IN ANOG Boi Suetsseete ie cdecen eters wacecuseetinues malloc(3C) 
IWANOG cas ein toisdiwsna a tueceeeevisaet malloc(3xX) 
manage binary search trees ............. tsearch(3C) 
manage hash search tables ............. hsearch(3C) 
manipulate line number entries of .... Idlread(3X) 
manipulate parts Of ...... ee eee eee eens frexp(3S) 
MANUAL NAW sicccesstadiesier cee ctoesieenses man(1) 
map of ASCIl character set ascii ...... ascii(5) 
mark differences between files .......... diffmk(1) 
MASK UMASK: ii idecivencesed castes deedeavdeances umask(1) 
MASK UMASK ........cccccecscesecscesscnceceeeees umask(2) 
MASK UNMASK ccstessteriics cee achs, umask(2S) 
match routines regexp ...........eeeseeeeee regexp(5) 
PVN AL esse Secsecocacegscccentectnes oo ceteceancdssveasaaes math(5) 
IPAM OE eccrine stuescvieseerseceieieccre cates ds matherr(3M) 
maximum-value functions Max ......... max(3F) 
MAZE MVAZO® sesct ecicsecehestzscinseeaeveces .-. maze(6) 
MGCIGCK: ccssecavecesinwsecansaneapecdt cavnacactedvivess mclock(3F) 
mdial dial the P/75 onboard ............. dial(1) 
TVG Soi apa vias earen ceadvaavsaeet cei teuo secant mem(7) 
member of an archive file .................. Idahread(3X) 
memory allocator mMallOc ..............008 malloc(3C) 
memory allocator malloc ...............08 malloc(3X) 
MEMOTY AS ISK ........cccccsccerscncnesssorenes ramdisk(1M) 
memory control operations. ............... shmctl(2) 
memory id remove a messa¢ge .......... ipcrm(1) 
MOMOLY MON. ceiiiietacctcidaiei nccacieisctines mem(7) 
memory operations memory .............. memory(3C) 
memory operations Shmop. .............4. shmop(2) 
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Fortran minimum-value functions 
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overview of accounting and 
make a directory 
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build special file 

or a special or ordinary file 
make a unique file name 
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formatting documents 
document compatibility checker 
viewgraphs, and slides 
mounted file system table 
remaindering intrinsic functions 
change 

set file-creation 

chmod change 

dial a Racal-Vadic 3451 

mdial dial the P/75 onboard 

a compiler/interpreter for 

touch update access and 

' set file access and 


prepare execution profile 

guessing game 

for crt viewing 

package for formatting documents 
mount 

establish 

mount and dismount file system 
mount a file system 

mnttab 


copy, link or 
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MEMOLY DIOGK gs cc ccceicsscziccicccncctsesesescces plock(2) 
memory segment ShHMGet ...........eeseeee shmget(2) 
memory to be used as a disk ............ rram(/) 
IICTIIOIY Saeccdinsceccescecivewsuelexcecendvoasseeeeede memory(3C) 
MEFGe [OS SOM soi cissececessecassentsscoussevess sort(1) 
merge or add total accounting ......... acctmerg(1M) 
merge same lines of several files ...... paste(1) 
TCSO: “assencsveceenacesiiscdveccadesususcovecereseneve ‘mesaq(1) 
message control operations ............. msgctl(2) 
message operations MSQOp .............. msgop(2) 
message processing system ............. mailx(1) 
message Queue MSGGet ...........ceceeeeee msgget(2) 
message queue, semaphore set or ... ipcrm(1) 
messages from UNIX to console ....... conslog(7) 
MESSAGES MCSG .......ccsccececcececcesceresees mesg(1) 
MESSAGES PEPIOF ........cceeseesesecesseeceseees perror(3C) 
GULL ss Atsacceceecslevccductatevesuiges corsdeanzaaweeaes min(3F) 
Mirrored GiSk Criver .........ccsceccsccscsecees dsk(7) 
mirutil utility for connecting .............. mirutil(1M) 
miscellaneous accounting commands acct(1M) 
WK GIO, cadecsreccc sez vinci ees fac eek eu contoesenccees mkdir(1) 
mkfs construct a file system .............. mkfs(8) 
US ocoie tebe ceuchaece Baca se aes cieeiannc asa mkfs(1M) 
mknod make a special file ................ mknod(2S) 
MIKNOG) boc. Sescececedescactesstesgannceco evens eeayeeas mknod(1M) 
mknod make a directory .............cc000 mknod(2) 
MIKIGIN Os schcocecsvaraesbsisiseeceetoniceus ose mktemp(3C) 
mm print/check documents .............. mm(1) 
mm the MM macro package for ....... mm(5) 
mmlint sroff/MM nrotf/MM.  .......cccccseee mmilint(1) 
mmt typeset dOCUMENTS, ...........csceeeee mmt(1) 
PTV acs ecta wa recnanea doce texscssancsaseaseanssess mnttab(4) 
MOG FORA, ccsciiinsivendetesiceesiteestenseeen mod(3F) 
MOS CHIMOG secccssccccicccescdescendsssevanteess chmod(1) 
MOde MASK UMASK .........cccscsseeeseececees umask(1) 
MIOOG. OF Te ci cciwssaeanveseverdeiiwepiacsaszanecs chmod(2S) 
NOGGIN arene cecccciiwincssceascaacecauescuueswucdeees dial(1) 
RIO COIN sakes ceccasscarecuataccascteceuacivenceasadeess dial(1) 
modest-sized programs Ds .............. bs(1) 
modification times of a file ................ touch(1) 
Modification times UtIME ..........eeeeeeeee utime(2) 
monitor uucp network uuSsub ............ uusub(1M) 
MMOMILOR ss isessenci sted or oescen cates cieavont monitor(3C) 
OO ence soesecivsaveeadicecaseouecte ns eedeseeeuke moo(6) 
more, page file perusal filter ............. more(1) 
mosd the OSDD adapter macro ........ mosd(5) 
Mount a file SYStEM ..........cecccesceseeees mount(2S) 
mount table SCtMNt .......... cess eee eee eee setmnt(1M) 
MNOUIIE accsccekecesccianacvnivsssuscdceswanssubstensen mount(1M) 
POU aoeeaa sce sasscsivecwoscc wesdedaeies tustaveetecee NOUNTE) 
mounted file system table ................. mnttab(4) 
MOve a CirectOry MVAIF ..........cceseeeeene mvdir(1M) 
MOVE TIES CP: savesiaciwiecewsdeciesessis ascckaisns cp(1) 
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nm print 

get login 

make a unique file 

find 

print 

get 

get the 

get character login 

return login 

working directory 

system ff list file 

deliver portions of path 
conventional 

generate 

print user and group IDs and 
function log Fortran 

generate names from i-numbers 
Fortran 

character definitions for eqn and 
a command on the PCL network 
commands stat statistical 
monitor uucp 

change the format of a text file 
log in to a new group 

print 

process 

run a command at low priority 
change priority of a process 
line numbering filter 

get entries from name list 
name list of common object file 
immune to hangups and quits 
setimp, longjmp 

9700 printer x9700 prepare 


( } 


Plexus Sys 5.21UNIX 


PERMUTED INDEX 


move read/write file pointer 


sce da voreasats Iseek(2) 

move read/write file pointer .............. Iseek(2S) 
move requests start/stop the ............ lpsched(1M) 
mptx the macro package for ............ mptx(5) 
FU SO GU sesci cinctninnidencerddasccecunss eoeieccesediece msgctl(2) 
PISO O Ol seckecarsuccaGaveiceetytevewsxeced ointesiis msgget(2) 
VSO OD ecwarecdeuseenseueusideretencbaustolanasataees msgop(2) 
WAV UG ACD) cawee cacckexecescacvenssecksousncexsieeies cp(1) 
mv a macro package for making ...... mv(/) 
mv a troff macro package for ........... mv(5) 
FAV GIE scictuecshass chen xe eaedcebealeevinscesesten ews mvdir(1M) 
PAINS GOV sien diacscercaventreteehciececcaenee devnm(1M) 
name for a temporary file ................4. tmpnam(3s) 
name for common object file ............ Idgetname(3X) 
name for terminal ctermid .............0008 ctermid(3S) 
name from UID getpw ........eesseeesensees getpw(3C) 
NAMC QELENY ~sixiwiceccedessacetesavane oeens casei getenv(3C) 
RAME GetlOGin: ccccnccccsssscccseisecccesccsousacte getlogin(3C) 
MAME liSt NNISt se sescssinedcsecearesdesvadesevence nlist(3C) 
name list of common object file ........ nm(1) 
NAME LOGNAME .........ccccsscecssesecscncosceees logname(1) 
NAME MKOMP ...........cceceescnnsccesceenccesce mktemp(3C) 
name of a terminal ttyname .............. ttyname(3C) 
name of current UNIX system ........... uname(1) 
name of current UNIX system ........... uname(2) 
name of the terminal tty 2... tty(1) 
name of the uSer CUSELIC ........cccceeceee cuserid(3S) 
name Of user lOgGnaME .............secesseee logname(3X) 
MAING PWG. ccd cecescseseiccecncccncenceseccecnciscess pwd(1) 
names and statistics for a file ........... ff(1M) 
NAMES DASENAME 22... .ccescccscscccccscccceses basename(1) 
names for terminals term .................. term(5) 
names from i-numbers ncheck ......... ncheck(1M) 
AINCS 1s neo actie cere ocaseeicwessneeeteiass id(1) 
natural logarithm intrinsic .............6. log(3F) 
PGIIOGK > sbocc tect so dacwe Re secewecciatoudecoseatedeveds ncheck(1M) 
nearest integer functions round ....... round(3F) 
neqn eqnchar Special .............ceceeceeee eqnchar(5) 
MEC-CKECUIG  ccsibeseevtoiceicwiecves tecdsayeuneweds net(1) 
network useful with graphical ........... stat(1) 
MNETWOrK UUSUD 1.00... cee cecccecesescccecnceees uusub(1M) 
PIG WIOUIW cctinincautes erence dovedseraecdicntesiasticas newform(1) 
NOW OID ses). senrueuessestatie en lect snacentecses es newgrp(1) 
NEWS ITEMS NEWS  ......cccceceveccecscecteeecees news(1) 
nice change priority Of a ........ esses nice(2S) 
WIGS: ssccste cence usdacaSecedusneweeadauecrseeteidsuesees nice(1) 
PICS coal jacerudacsuxasesanaleydeveanadeseinueveiseacacs nice(2) 
Oil Bo decusaney Sores caaesedeeaseeraauedeeta.s cre deeeuteas ni(1) 
RVUISE sud pcanccewecyunctadadiwesaacgusonseseeaseaues nlist(3C) 
PAV OUI avetosiieenhcuseadabileclaatawesdetesatayes nm(1) 
NOHUP FUN A COMMANG .......ccesceecseeees nohup(1) 
NON-lOCAl GOTO ...........eeceesccescnsvcesccneees setimp(3C) 
nroff documents for the Xerox .......... x9/00(1) 
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file linenum line 

file function manipulate line 
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factor a 

provide drill in 

random 

object strip symbol and line 
report 

string to double-precision 
convert floating-point 

line 

distributed pseudo-random 
parts of floating-point 

access graphical and 

common 

dump selected parts of an 

open a common 

line number entries of a common 
close a common 

read the file header of a common 
entries of a section of a common 
optional file header of a common 
entries of a section of a common 
section header of a common 
section of a common 

a symbol table entry of a common 
symbol table entry of a common 
to the symbol table of a common 
line number entries in a common 
print name list of common 
information for a common 
section header for a common 
number information from a common 
retrieve symbol name for common 
syms common 

file header for common 
directories cpset install 

link editor for common 

print section sizes of common 
find ordering relation for an 

od 

text for otroff 

octal dump 

octal dump 


mdial dial the P/75 
reading Idopen 
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— 
nroff format or typeset text .............00 nroff(1) \ 
NFO OF THOT cies sachs Dados dactecieiesebesszcaes tbl(1) SN? 
nroff/MM document compatibility .... mmlint(1) 
nroff/troff, tol, ANG EQN ............cseee sees deroff(1) 

UN TNS UU J scxesescndeekdeectet neecesocvstersens null(7) 

number entries in a common object . linenum(4) 

number entries of a common object . Idiread(3X) 

number entries of a section of a ....... Idiseek(3X) 

NUMDEL FACTOM ...........cccccecsccesssseccesceeee factor(1) 

number facts arithmetic ................c00 arithmetic(6) 

number generator rand ..........secceeeeees rand(3F) 

number info from a common ............ strip(1) 

number of free disk blocks df ........... df(1M) 

number sStrtod CONVET ............cccesceees strtod(3C) 

number to String CCVt ...........ceceecseseees ecvt(3C) 

numbering filter Nl... te teeweeee ni(1) 

numbers drand48 uniformly ............. drand48(3C) 

numbers frexp manipulate .............06 frexp(3S) 

numerical commands graphics ........ graphics(1) 

object file access routines Idfcn ....... Idfcn(4) 

Object file CUMDP ......... ee ceceeeeeeceeenee ees dump(1) 

object file for reading Idopen ............ Idopen(3xX) 

object file function Idlread ................ Idlread(3X) 

Object file IdclOSE ..........seeeececeeeeesceee Idclose(3X) 

Object file Idfhread ............. ce cceceeseceeee Idfhread(3xX) 

object file Idlseek line number .......... Idiseek(3X) es 

object file Idohseek seek to the ......... Idohseek(3X) A § 

object file Idrseek relocation ............. Idrseek(3X) ee 

Object file IdShread .............cececcecesneeee Idshread(3X) 

Object file IDSSEEK .........csccsseecseeccecseee idsseek(3X) 

object file Idtbindex index of ............ Idtbindex(3X) 

object file Idtbread an indexed ......... Idtbread (3X) 

object file Idtbseek seek ...............cece6 Iidtbseek(3X) 

Object file INENUM ....... tee eee eeeeeeees linenum(4) 

GDIGCE THEN iwasiaessicecseccssiersecuneccaxees nm(1) 

Object file reloc relocation ..........cecen reloc(4) 

Object file SCNNA ...........ceceecececerevcnceee scnhdr(4) 

object file strip and line ........ ee strip(1) 

Object file symbol table entry ............ Idgetname(3X) 

Object file symbol table format ......... syms(4) 

Object files filENCr ...... teeta eee eee ees filendr(4) 

Object files IN DIMATLY ......... et eeeeeeeeeeeee cpset(1M) 

ODIECU MES 1d doccinveevtetesveedossranwevtediees Id(1) 

ODieCt TleS:SiZe> Aecicsncsciveseceeceotaesivens size(1) 

Object library lorder 0... ee ssee ones lorder(1) 

OCLC ais aero was raes cise ea ee nae etoeen ee od(8) 

ocw prepare constant-width ............. ocw(1) 

OG Maw avcvorwianeeveustecsuaténtieesccntetitaewene deer od(8) 

OG oie a scSca rau aseabinvtseceeoed tase ucenseecvenuesses od(1) 

Od Optical Gisk ..........ceeescssccsessececcanes od(7/) 

ONDOAI MOEM ..........cceecssececeseeeneces dial(1) 

open a common object file for .......... Idopen(3x) a 

Open a stream fOPeN ..........scccseesssseeee fopen(3S) \ 2 
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semaphore control 
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od 

rod raw interface to 

copy file systems for 

CRT screen handling and 
vector getopt get 

object file seek to the 

driver dsk 

file control 

set the 

parse command 

library lorder tind 

make a directory or a special or 
prepare constant-width text for 
connection dial establish an 
common assembler and link editor 
tc troff 

troff description of 

vprintf print formatted 

print formatted 

miscellaneous accounting 
change 

change 

compress and expand files 
screen handling and optimization 
mv a macro 

system activity report 

standard buffered input/output 
interprocess communication 
crt viewing , 

4014 terminal 4014 


Ppp 
get process, process group, and 


Fortran integer 

deliver the last 

Fortran imaginary 
dump selected 

frexp manipulate 
change login password 
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open file descriptor Gup ..............ceeeee dup(2) 
open for reading or writing ............... open(2S) 
ODGIN acaseuasicoccsaeedectadesdudenccacses vi cecteaseune open(2) 
operating system profiler .................. profiler(1M) 
Operation OUTINGS .......... cece eeeeeeeecee eee termlib(3C) 
OPELatioNS MEMOLY .........ceceeecessecceeees memory(3C) 
OPeEratiONS MSGCHl ........ccceecessesceeeeeeeee msgctl(2) 
OPeratiONS MSGOP ............eeseceseeneeeeees msgop(2) 
Operations SEMCH ....... cee ceeeeceweceeeee semctl(2) 
OPeratiONS SEMOP ...........ceeeeeeseeeceeeees semop(2) 
Operations SHMCHI ......... eee eee eee scenes shmctl(2) 
OPeratiONS SNHMOP .........cseeeseeeeeeeeceoes shmop(2) 
Operations StriNG ...........ceceeeseeeeeeeeeeees string(3C) 
OPEatOr OM: sicsessedsessidssindusseseciaeinoess join(1) 
ODUUGal GISK. icciiiereatinetasamnnunetevevertetinces od(7) 
ODUGAIMAISK -iissecchinsscanednctedeneiiaesiazeaase od(/) 
optimal access time dcopy ............... dcopy(1M) 
optimization package curses ............ curses(3X) 
option letter from argument .............. getopt(3C) 
optional file header of a common ..... Idohseek(3X) 
optionally mirrored disk ................c00 dsk(/) 
ODUONS TONY: cosctasetepacencancaseoesncess counts fentl(S) 
options for a terminal sStty ................. stty(1) 
OPUlONS QElO DO ce nc ecettatiananedendansivees getopt(1) 
ordering relation for an object .......... lorder(1) 
ordinary file MKNO .......... eee ee cececeeenee mknod(2) 
OUOM OCW sesest Nene de ectaeiccioeess ocw(1) 
Out-going terminal line .............ccceseees dial(3C) 
OUTDUL ALOUE cxcseccatsiccccectvasncestecosescsscens a.out(4) 
Output interpreter 2... cecsscecseeseeeees tc(1) 
Output LANGUAGE ...... eet eseeeeeeeeeceeee ees troff(5) 
output of a varargs argument list ..... vprintf(3S) 
OUTPULDIINI, .ecossersersstadesreetencstaceseesens printf(3S) 
overview of accounting and ............. acct(1M) 
Owner and group of a file chown ...... chown(2) 
OWNED OF GrOUP CHOWN ........ccececeseeeees chown(1) 
DAC vacdienseuasle lib vccatavoteueastaesstue Ouaetes pack(1) 
package Curses CRT .......secesseesceeeeeees curses(3X) 
package for making view graphs ..... mv(7) 
DACKAGE SAP .......ccceccsceceecsecceccerescneoes sar(1M) 
PaCkade SIGIO. sicccscsecsvecasncasiavcocenvaecdens stdio(3S) 
package stdipc standard ................. stdipc(3C) 
page file perusal filter for .................. more(1) 
paginator for the TEKTRONIX ........... 4014(1) 
parallel port interface ....... cee eeeeee pp(/) 
parent process IDs getpid ................. getpid(2) 
parse command options getopt ....... getopt(1) 
part intrinsic function aint ................ aint(3F) 
DareOl a TOTAL isscsaidoasvmetartensczneiees tail(1) 
part of complex argument aimag ..... aimag(3F) 
parts of an object file dump. .............. dump(1) 
parts of floating-point numbers ........ frexp(3S) 
DASSWOL fae, sees lckiauis scatareuencaleanadevhew ns passwd(1) 
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password file 

get 

write 

read a 

pwck 

or subsequent lines of one file 
deliver portions of 

directory getcwd get 
USERFILE UUCP 

search a file for a 

language awk 

suspend process until signal 


format acct 
acctcms command summary from 
USERFILE UUCP pathname 


macro package for formatting a 
system error messages 

page file 

terminals pg file 

drawing simple pictures 
preprocessor for drawing simple 
split a file into 

initiate 

create an interprocess channel 
process, text, or data in memory 
graphics interface subroutines 
graphics interface 

reposition a file 

move read/write file 

Iseek move read/write file 

the current value of a file 
initiate pipe to/from a process 
pp parallel 

data base of terminal types by 
and library maintainer for 
deliver 

number on a tape srcheof 
functions dim 

make 

printing Iphold 

exponential, logarithm, 


print files 

function dprod double 
monitor 

Xerox 9700 printer x9700 
Xerox 9700 printer dx9700 
the C language 

pictures pic troff 

unget undo a 
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perusal filter for soft-copy 


DASSWO ciscre ho wcgiclucuscevecudeceeeeesueuesiateee 
password file entry getpwent 
password file entry putpwent 
PASSWOITC GetPASS ..........ceececescensceecees 
password/group file checkers 
paste lines of several files 
Dall I aAMES.. crscedeec pencevuiecesscsserastete viii 
path-name of current working 
pathname permissions file 
DAUIOEA QLOD onc. cites wesdvaassasvadensalenseesients 
pattern scanning and processing .... 
DAUSE i escuccsccichowevisswaccesheesdeseseaiariouee 
pd IMSP disk controller ...............-0-06 
per-process accounting file .............. 
per-process accounting records 
PEFMISSIONS filO .........ecsccececeecsceecerenes 
permit or deny messages mesg 
PErMUted INGEX PtX ....cssccrccssccenscccseees 
permuted index mptx the 
DOIG ON sce capaiacacuaussteabousesueaesnstcgeseteesecaae 
perusal filter for crt viewing 


eeessseecereeoces 


pic troff preprocessor for 
pictures pic troff 
DIOCES- SPIE sain easdeducstbvetasss eatstvevsen sens 
pipe to/from a process popen 
pipe 


SOCHCHHSHSERHEHCHESHSSSCOHOHREHESEBOTE 


weesesoeuves 
SCSSHSHSSSCHSHRSCTSSCSHSHSHHHHHSSHSSOHSCSHHEHSCHESHTESHHREHEBBGASEe 


SPSSSOSHSHHSSEHSSSHSSHLSHSOCHOSSHHSSEEOSKESHEEASES 


plot 
DIOL ceccsrcbvescotoutaescisa savadectiaesbescsuweneaactes 
pointer in a stream fseek 
pointer Ilseek 
DOINIGE cadicucssescenscucnccucecvesacsssucenssieessies 
pointer tell report 
DODGN aavinaces the denccecasteeserasutacecaessuncst 
port interface 
port ttytype 
portable archives ar archive ............. 
portions of path names basename .. 
position to a specific file «0.2... ee 
positive difference intrinsic 
posters banner | 
postpone printing, resume ................ 
power, square root function 
pp parallel port interface 


SHSSHSSHHHHKTHARHSHSSHSHSSHHSSTSHSCEHSSAGHSSSEHSHAtAGSHBESE 


SSHSESSSTOTSSHHSOCOHSHTHSHSCOHRAOSHUBEHEHE 
eesenevneeceoeecseanseaasvpessanves 


SRHHESOAHEHSHLEHSHEEHRESeLEEEEBEBEFEETEH 


eeeseoevecanaos 


precision product intrinsic 
prepare execution profile ................+. 
prepare nroff documents for the 
prepare troff documents for the 
PYEPIOCeSSOFL CNP .......ssessecssececsseceesees 
preprocessor for drawing simple 
previous get of an SCCS file 


aeeseecossvanaven 


passwd (4) | 
getpwent(3C) =.” 
putpwent(3C) 
getpass(3C) 

pwck(1M) 

paste(1) 

basename(1) 
getcwd(3C) 
USERFILE(4) 

grep(1) 

awk(1) 

pause(2) 

pd(/) 

acct(4) 

acctcms(1M) 
USERFILE(4) 

mesg(1) 

ptx(1) 

mptx(5) 

perror(3C) 

more(1) 

pg(1) 

pic(1) 

pic(1) 

split(1) 

popen(3S) eo 
pipe(2) =e 
p | ock(2) Se” 
plot(3XxX) 

plot(4) 

fseek(3S) 

lseek(2) 

lseek(2S) 

tell(2S) 

popen(3S) 

pp(/) 

ttytype(5) 

ar(1) 

basename(1) 
srcheof(2S) 

dim(3F) 

banner(1) 

Iphold(1) 

exp(3M) 

pp(/) 

pr(1) 

dprod(3F) 

monitor(3C) 

x9/00(1) 

dx9700(1) 

cpp(1} 

pic(1) _ 
unget(1) 
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Ipstat 


of a file sum 
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cat concatenate and 
varargs argument list vprintf 


on printer 
file nm 
system uname 


acctcom search and 

topq prioritize 

object files size 

names id 

other strings find the 

with the MM macros mm 
requests to an LP line 
documents for the Xerox 9700 
documents for the Xerox 9700 
enable/disable LP 

print formatted output 
postpone printing, resume 
topq 

run a command at low 
change 

nice change 

faster file system checking 
getpid get 

process group, and parent 
errpt 

errors errpt 

enable or disable 

acctcom search and print 
set a 

get 

init 

timex time a command; report 
terminate 

create a new 

set 

iDs getpid get process, 
script for the init 

terminate a 

change priority of a 

kill send a signal to a 
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primitive string, format of ................. gps(4) 
primitive system data types .............. types(5) 
print LP status information ............... Ipstat(1) 
print an SCCS file prs oo... eeee ee eee prs(1) 
print and set the date date ................ date(1) 
DFiNt CAleENGAal CAL wcocccscccvsccsccssssseccccess cal(1) 
print checksum and block count ...... sum(1) 
print current SCCS file editing ...... ... Sact(1) 
print entries in this manual ............... man(1) 
DriMU TIES Cat snsrccs cece alelkos eicesuedesensier cat(1) 
BRINE INES D9 -cccccscigectersscecsohucesiectonsecease pr(1) 
DEINE TICS wanses cor vccsnelccaeen se tececosvescdeevecs cat(8) 
print formatted output of a ............... vprintf(3S) 
print formatted output printf ............. printf(3S) 
Print large DANNEYL oo... te ceeceeseeneeeeee bbanner(1) 
print name list of common object ..... nm(1) 
print name of current UNIX ............08 uname(1) 
Drint NEWS ITEMS NEWS. ..........cecssccnccees news(1) 
print process accounting file(s) ........ acctcom(1) 
LINE QUCUE: 152 srcccessgvasuecaneseusaceaccoasiners topq(1M) 
print section sizes of common ........... size(1) 
print user and group IDs anid ........... id(1) 
printable strings in an object, or ...... strings(1) 
print/check documents formatted .... mm(1) 
printer Ip Send/Cancell ..........cssssceseeees Ip(1) 
printer prepare Nroff ...........eeceesseeeee x9700(1) 
printer prepare troff oo... eeeeeseeeeees dx9700(1) 
PIFINters ENADIES ............ceeesecseeeeecescoees enable(1) 
PRU cc sacaescuwenveavessouccvectveacesdes etetewesecacs printf(3S) 
PFU saeuscUarvacecsiestevecectreadSebdseweteerens Iphold(1) 
Prioritize Print QUEUC 2.00... ee ecceeeeeeees topq(1M) 
DEIOUIRY MICE stateccatecsestvee, cecesesetades atzew: nice(1) 
priority Of A PrOCeSS NICE 2.2... see eeeeee nice(2) 
Priority Of A PFOCESS .......ccseecesseeteneves nice(2S) 
procedure Checkall ............ccscescseneenees checkall(1M) 
DROCESS IDG sccivecsi ictns cc cock caueewdiavebses getpid(2S) 
process IDs getpid get process, ....... getpid(2) 
process a report of logged errors ..... errpt(1M) 
process a report of logged ............... errpt(1M) 
Process ACCOUNTING ACCT... eeeeeeee acct(2) 
process accounting file(S) ..............66 acctcom(1) 
process alarm clock alarm ...........066. alarm(2) 
process and child process times ...... times(2) 
process control initialization ............ init(1M) 
process data and system activity ..... timex(1) 
DIOCESS: CXL” seesiaivetevcunsitenscevewecuecavanviee exit(2) 
DI OCESS FOMK cs, sea eavgetuncatvetwndtessuel entavon vc fork(2) 
process group ID setpgrp ................ setpgrp(2) 
process group, and parent process . getpid(2) 
PFOCESS INIttAD ...........cecssscccscsensessennes inittab(4) 
DIOCESS KIND aicsacsinnnctadesusvetewieesseceteenens kill(1) 
DFOCESS NICE: 224.50. nese ihdedeeks Gandeaviesntene nice(2) 
process or a group of processes ..... kill (2) 
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initiate pipe to/from a 
report 

get process and child 
wait for child 


suspend 
await completion of 
exit terminate 


nice change priority of a. 


parent process IDs getpid get 
plock lock 

list of file systems 

signal to a process or a group of 
kill all active 


structure fuser identify 


pattern scanning and 
terminate all 

interactive message 
macro 

double precision 
display profile data 
profile within a function 
execution time profile 
display 

prepare execution 
execution time 
environment at login time 


up an environment at login time 
disk access 

operating system profiler 
terminate Fortran 

verify 

C 

aC 

generate C 

C 

Ist locations in 

dataio download 

for getargv display a 
side-by-side difference 
conversion 

the standard/restricted command 
for modest-sized 


lex generate: 


update, and regenerate groups of 
arithmetic 
for reading or writing lockf 


print an SCCS file 


report process status 
generate uniformly distributed 
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DIFOCESS PODEN: ccccccicccccsoeccnccsestessesesens popen(3S) 
PIFOCESS StatuS PS ........cssccesscceeseonceees ps(1) 
PIFOCESS tIMES ............cccceccncccecccescecnee times(2) 
process to stop or terminate wait ..... wait(2) 
PrOCeSS trace Ptace ...........eeseececenes ptrace(2) 
process until signal pause ................ pause(2) 
DIOCESS Wal D seseececesicccisscchiuastecsedesueneses wait(1) 
DFOCOSS osicissictiaciawscventoeeesteiwessctecsenwive exit(2S) 
DIOCESS: ccscicercenese inset aceece reserva caesnn nice(2S) 
process, process group, and. ............ getpid(2) 
process, text, or data in memory ...... plock(2) 
processed by fsck checklist .............. checklist(4) 
processes Kill SENd @ .........ecccceseeeees kill(2) 
Processes killall ................sccssssssecsesees killall(1M) 
processes using a file or file ............. fuser(1M) 
processing language awk .............066 awk(1) 
PrOCeSSING SNULGOWN ..........cccecscseceees shutdown(1M) 
processing system mailx ................00 mailx(1) 
DIOCESSON MA. sisscacsicctccsedenascauvecdsaacesds m4(1) 
product intrinsic function dprod ...... dprod(3F) 
DOD a vecutencocarcetuasvevcuates tate ucatetearalevaneay prof(1) 
MON ids eccivncsrdesial cocamsatneceaaeundndaskvect eds prof(5) 
DT Olih cocdueesioestevceaceentectinsen ea rdveneeedcsess profil(2) 
profile data Prof... eccssseeeeceeeees prof(1) 
DrOFfile MOMNITON ............cccessccrsceevesceceees monitor(3C) 
DONNIE DlOl vstesdestacatlccncwidecsccesseecee profil(2) 
Profile SettiINg UP AN... eectssseseneees profile(5) 
profile within a function prof ............ prof(5) 
PrOfile SELtING ..........cccssccssccsssecescsseenes PFOFIlE(4) 
profiler sadp ............. Sasblodusee dives tiedees sadp(1M) | 
DIOUICM: ivuicssenccaseoeecesvestisnieuvieiteeute vers profiler(1M) 
PFOGrFaM ADOSt ..........eeeecceccesseesseseseees abort(3F) 
program assertion assert ............. weeee ASSEIT(3X) 
program beautifier CD ..........sscecescees cb(1) 
program checker lint ............sssececesneee lint(1) 
program cross-reference cxref ......... cxref(1) 
Program debugger Ctrace ...........ceseee ctrace(1) 
DrOOlaii: GIVE s.ccssacecsselatecciauseccaiees end(3C) 
DIOGram THES. cccvisiveccsevececsseecesecwessectess dataio(1M) 
program name and get arguments ... getargv(2S) 
DFOOam SCIll a siicesissecectsercescieneseiseans sdiff(1) 
DPOGKAM UNIS sescdccecsicnscesccsensesesccoonnsss units(1) 
programming language sh shell, ..... sh(1) 
programs bs compiler/interpreter .... bs(1) 
programs for simple lexical tasks ..... lex(1) 
programs make maintain, .............. . make(1) 
provide drill in number facts ............ -arithmetic(6) 
provide exclusive file regions ............ lockf(2) 
provide truth values true ...............e00 true(1) 
OES acetic calarecscigterviaulacseeveceveeiteeesanwienseus prs(1) 
DS: cctv ovenisuvaceixveiancehieeeacaantevitasacacs¥ancteies ps(1) 
pseudo-random numbers drand48 .. drand48(3C) 
pt IMSP cartridge controller .............. pt(7) 
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process trace 


permuted index 


copy uuto 
stream ungetc 


stream putc 


or add value to environment 
write password file entry 

put a string on a stream 
password/group file checkers 
working directory name 


topq 


quicker sort 


get message 
prioritize print 


memory id remove a message 


a command immune to hangups and 
test your knowledge 


simple random-number generator 
random number generator 
rational Fortran dialect 


split f77, 


rod 
rm 
rdsk 
of dsk 


entry of a common object file 
header of a common object file 


read 


send mail to users or 


member of an archive file 
object file Idfhread 


lockf exclusive 


read from file 
file regions for 
move 

_ {seek move 


open a common object file for 


open for 
open open for 


get real and effective user, and 
real effective group get 

specify what to do upon 
specify Fortran action on 

from per-process accounting 
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DU ACO sxcoseccaunedesechtecetieseateteseancoenteneeees ptrace(2) 
UK woaedasetetelesnesades cece tot orb ccs cebteuseauebees ptx(1) 
public UNIX-to-UNIX system file ....... uuto(1) 
push character back into input ........ ungetc(3S) 
put a string on a stream puts ........... puts(3S) 
put character or word ON @ .........2008 putc(3S) 
DULENV: CRANGEc.cescwecsidsccthexcesscentesces putenv(3C) 
DUD WEIN osc co ecccoideccauscucteactdetaderasarens putpwent(3C) 
DUNS cote cvncscchieosSecccouchenateseelanvaweneesue eins puts(3S) 
DWGK, soassdseavs gs dccieasesscawacecewscceseusesdencuceen pwck(1M) 
DW do ee. eecseceascdea ah sncecwavuenl eaten acnsaet pwd(1) 
SOU iisseidaGicvcscnssnuiensescnsaesveteseetesedaue? qsort(3C) 
query terminfo database tput ........... tput(1) 
QUEUE MSGGET ............cerecrreeceeceeseneceees msgget(2) 
QUO Se catesinsae vaseen a sdacdccceatewicecssaweeateves: topq(1M) 
queue, semaphore set or shared ...... ipcrm(1) 
Quicker SOM GSOM ncccscesesticecwsaietstrcise qsort(3C) 
QUITS NONUP FUN 20... ieee cee eeeeeeeeeees nohup(1) 
QUIZ i veredevsrsyedsseesnensl ween sicienceweaaveasewies quiz(6) 
ramdisk memory aS diSk .............0c00 ramdisk(1M) 
CONG revue ts A cmicrssccteeee nse aeun ccc tccaseiaacest rand(3C) 
PANIC: 2asraveacvon cet tecoeae stones eevnenen aneetesweseess rand(3F) 
FACIOM. cetessusserasecptactaccawsdescoesesenicrexeearn ratfor(1) 
ratfor, or efl files fsplit oo... eee fsplit(1) 
rational Fortran dialect ratfor ........... ratfor(1) 
raw interface to optical disk ............. od(/) 

raw reei-to-reel tape driver ............... rm(7/) 

raw (unbuffered) version of dsk ........ dsk(7) 

rdsk raw (unbuffered) version ........... dsk(7) 

read a paSSword Getp4SS .........- esses getpass(3C) 
read an indexed symbol table .......... Idtbread(3X) 
read an indexed/named section ....... Idshread(3X) 
read from file read ................ Cgetuwadnezs read(2) 

POAC TOM TG: dooncecccad rancsncoetotevesneseaes read(2S) 
POAC Mail MAN: ccdavckcvccchetatmdsestsiavennns mail(1) 

read ONE NINE VINE 0... cee cece ee cee tec ee eens line(1) 

read the archive header of a ............ Idahread(3X) 
read the file header of a common ..... Idfhread(3xX) 
KO AG: ctuasesapers seucsscaiccnas tense vveaccoteereeenens read(2) 
reading OF WHITING ..........ececeecseneeee neces lockf(2) 
read/write file pointer Iseek ............... Iseek(2) 
read/write file pointer ...............cesesees Iseek(2S) 
FEAGING ICOPEN ssccssensscacsscececeseceevesseee Idopen(3X) 
reading OF WritiNG OPEN... eeeseeeeee open(2) 
reading OF WHITING ........ eee eceseeeeereeseees open (2S) 
real and effective group ID ................ getuid(2S) 
real and effective USEF, ...........ccccsceeees getuid(2) 
receipt Of a SIQMAl oo... ee ceceeeewenees signal(2) 
receipt of a system signal ................. signal(3F) 
records acctcms command summary acctcms(1M) 
records from dump errdead ............. errdead(1M) 
recover files from a backup. .............. frec(1M) 
reel-to-reel tape driver ...........ceeeeseeneee rm(7/) 
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rrm raw 
regular expression compile 
and execute regular expression 
make maintain, update, and 
compile and match routines 
lockf provide exclusive file 
match routines regexp 

regcmp 

compile and execute 

files comm select or 

lorder find ordering 

join 

for a common object file 

of a common object seek to 
common object file reloc 
functions floor, ceiling, 

mod Fortran 


uuxqt execute 
Lmds 
spawn getty to a 


file rmdel | 


semaphore set or shared memory 


constructs deroff 
consistency check and interactive 
consistency check and interactive 


consistency check and interactive 


consistency check and interactive 
report 


communication facilities 
blocks df 

process a 

system activity 

activity timex time a command; 


uniq 

system activity 

stream fseek 

requests start/stop the LP 
send/cancel 

uuxqt execute remote command 
brdrst 

restore 

incremental file system 
Iphold postpone printing, 
object file symbol table entry 
argument getarc 

variable getenv 

mclock 

abs 
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reel-to-reel tape driver 


FSOCMP veiseeutendet. 
regcmp compile 


regenerate groups of programs 
regexp regular expression 


regions for reading 


regular expression compile and 
regular expression compile 
regular expression regcomp 


reject lines common 


relation for an object library 


relational database 


reloc relocation information 
relocation entries of a section 
relocation information for a 
remainder, absolute value 
remaindering intrinsic functions 
reminder service calendar 
remote command requests 
remote execution commands 


remove a message queue, 
remove directory entry unlink 
remove files or directories rm 
remove nroff/troff, tbl, and eqn 
repair dfsck file system 
repair fsck, dfsck file system 
repair fsck file syste 
repair fsck file system 


repeated lines in af 


report CPU time used clock 


report inter-process 


report number of free disk 
report of logged errors errpt 


report package sar 
report process data 


report process status ps 
report repeated lines in a file 


report sail 


reposition a file pointer in a 
request scheduler and move 
requests to an LP line printer Ip 


requests 


reset the VCP controller 


restor incremental fi 
FOSIOlC sv cissssceccacivasn vs 
resume printing 


or writing ........... 
to two sorted .... 
operator ............ 
TD: ‘woxesevasevensaaserennd 
HE UNIG .......cceeeeee 
and system ....... 
le system ........... 


SCOKREOKESHHEEH RESO H EHSL EDEAES 


retrieve symbol name for common ... 


return Fortran command-line 
return Fortran environment 
return Fortran time accounting 
return integer absolute value 


sole 


etesscnosene 


rm(/) 
regcmp(1) 
regcmp(3X) 
make(1) 
regexp(5) 
lockf(2) 
regexp(5) 
regcmp(1) 
regcmp(3xX) 
comm(1) 
lorder(1) 
join(1) 
reloc(4) 
Idrseek(3X) 
reloc(4) 
floor(3M) 
mod(3F) 
calendar(1) 
uuxqt(1M) 
L.cmds(4) 
ct(1) 
rmdel(1) 
ipcrm(1) 
unlink(2) 
rm(1) 
deroff(1) 
fsck(1M) 
fsck(8) 
fsck(1M) 
fsck(8) 
uniaq(1) 
clock(3C) 
ipcs(1) 
df(1M) 
errpt(1M) 
sar(iM) 
timex(1) 
ps(1) 
uniq(1) 
sail(1) 
fseek(3S) 
Ipsched(1M) 
Ip(1) 
uuxqt(1M) 
brdrst(1M) 
restor(8) 
restor(1M) 
Iphold(1) 
Idgetname(3X) 
getarc(3F) 
getenv(3F) se 
mclock(8F) { 
abs(3C) Me 
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len 

substring index 

logname 

name getenv 

data 

filter 

create a new file or 
remove files or directories 
remove a delta from an SCCS file 
disk 

change 


chroot change 

logarithm, power, square 
Fortran square 

Fortran nearest integer functions 
graphical device 

common object file access 
expression compile and match 
graphical table of contents 
float and double 

as a disk 

driver 

nice 

and quits nohup 

run daily accounting 

SCCS file editing activity 

disk access profiler 

system activity graph 

system activity report 

system activity report package 
convert formatted input 

big file 

awk pattern 

programs 

two versions of an SCCS file 
format of SCCS file 

start/stop the LP request 
header for a common object file 
package curses CRT 

editor based on ex vi 

inittab 

system initialization shell 
side-by-side difference program 
grep 

binary 

accounting file(s) acctcom 
linear 

manage hash 

manage binary 

object file scnhdr 

file read an indexed/named 
seek to line number entries of a 
seek to relocation entries of a 
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return length of Fortran string .......... len(3F) 
return location Of Fortran ............cssee index(3F) 
return login name Of USEF ......seceeeee logname(3Xx) 
return value for environment ............. getenv(3C) 
returned by stat system call stat ....... stat(5) 
reverse line-feeds COl ...........s.sseceeceees col(1) 
rewrite an existing one creat ............. creat(2) 

RIO atau tru duswass eves oacen decade vewdsaes ade veuawonahes rm(1) 

PIVOT cores snesecdamascacansonceace sauediawananentions rmdel(1) 

rod raw interface to optical .............. od(7) 

root directory Chroot .........ccecesscsewseees chroot(2) 
root directory for a command ............ chroot(1M) 
root function exp exponential, .......... exp(3M) 
root intrinsic function sqrt .......... ee sqrt(3F) 
POUNG: coscteescaviedstceudvdecccudaedeeugneccaatecd eee FOUNA(3F) 
routines and filterS QdeV ...........cecseees gdev(1) 
FOUTINGS 1CICH ~ciscccdeticciecusedssescaeticaesoetas Idfcn(4) 
routineS regexp reGular ..........ssseeessees regexp(5) 
OUTINGS TOC scdcceccvcavecsdeceszes ees ssheeseveces toc(1) 
FOUUIMNES ncvccchccensonesssveuidescewsdeecaveeeusnavens float(2S) 
rram allows memory to be used ....... rram(7) 

rrm raw reel-to-reel tape .........ee eee rm(7/) 

run a command at low priority ......... nice(1) 

run comm immune to hngup ............. nohup(1) 
FUNACCE: scccsiewinsvanaceveevdiannstuastacececedeate runacct(1M) 
SACt PriNt CULLEN .........ccccscsesccnsveescees sact(1) 
BAC DG ose icces vaticg ola ctecsaduvccacesecuewoueaacceets sadp(1M) 
SAG) cicvaiecesecaseceiss ee cUnud leseveneuntovesaae $ag(1) 

SGIl: .cccehaseceskucisuciuasewensusscibecedesasseuaweacses sail(1) 

SAN acacezieve ve acdosene ceduatucbeccadetavaewsueiteciins sar(1M) 
SOANE acsasvoncsseadevevcvecacavededacsedisaulcaseteewes scanf(3S) 
SCANMMEC! DiSiigcniccecacecevatescchcabeveuteassaceus bfs(1) 
scanning and processing language . awk(1) 

scc C compiler for stand-alone ........ scc(1) 
SCCSGIff COMPAL ............ececnereesecnceenes sccsdiff(1) 
SCCSHIIC: <3 bs cl auawdarswnibedinadeldeckaskunesvaavanes sccsfile(4) 
scheduler and move requests ........... lpsched(1M) 
SCANG SECON sssicssciscsicenseacsceusasacdeeas scnhdr(4) 
screen handling and optimization .... curses(3X) 
screen-oriented (visual) display ........ vi(1) 

script for the init Process ...............00 inittab(4) 
SCHPUS DIG. e.svastsisaddvecstadance es dshoaveonenns brc(1M) 
SOU cceatadttaseheircavanaudvactedenexsece vote taeenies sdiff(1) 
search a file for a pattern ......... eee grep(1) 
search a sorted table bsearch .......... bsearch(3C) 
search and print Process ..........cecceeee acctcom(1) 
search and update Isearch .........0..60 Isearch(3C) 
search tables hsearch ...........seccsseesees hsearch(3C) 
Search trees tSearch ........cccscssecnsccseens tsearch(3C) 
section header for a common ........... scnhdr(4) 
section header of a common object . Idshread(3X) 
section of a common object file ........ Idiseek(3X) 
section of a common object file ........ Idrseek(3X) 
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seek to an indexed/named 
files size print 

stream editor 

section of a common object 
section of a common object file 
of a common object file 
common object file Idtbseek 
get shared memory 

change data 

brk change data 

to two sorted files comm 


file cut cut out 
dump dump 
semctl 


ipcrm remove a message queue, 
get set of 

semaphore control operations 
get set of semaphores 
semaphore operations 

group of processes kill 

a group of processes kill 

mail 

line printer Ip 

reminder 


umask 


umask 

map of ASCII character 

execution env 

modification times utime 

umask 

get 

remove a message queue, semaphore 


stty 
print and 
stty 


stime 


get and 

_assign buffering to a stream 
establish mount table 
non-local goto 

set process group ID 

login time profile 

login time profile 

speed and terminal 

set user and group IDs 
stream setbuf, 
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yo OS 
section of a common object file ........ Idsseek(3X) = : 
section sizes of common object ....... size(1) ? 
SOO oo cauniccetautensdacondcevcadecsdecsoanoesannteeereees sed(1) 
seek to line number entries of a ........ Idiseek(3X) 
seek to relocation entries Of a ........... Idrseek(3X) 
seek to the optional file header ......... Idohseek(3X) 
seek to the symbol table of a ............ idtbseek(3X) 
SegMent SHMGEt ............ceeeeeeseceeresnees shmget(2) 
segment space allocation brk ........... brk(2) 
segment space allocation .............c00 brk(2S) 
select or reject lines common ........... comm(1) 
select terminal filter greek ................. greek(1) 
selected fields of each line of a ........ cut(1) 
selected parts of an object file .......... dump(t) 
semaphore control operations. ......... semctl(2) 
semaphore operations semop ........... semop(2) 
semaphore set or shared memory id ipcrm(1) 
SEMAaPhOres SEM ............ceccesceececes semget(2) 
SONIC csccncesssenasussccsiusnudeaceverdevecsoucseeks semctl(2) 
SEMGOU sevavescesidasssieenicocscssencesenessenssiass semget(2) 
SEIN OD ano acai oak va ei cesss stad cncnoscesastevoesus semop(2) 
send a signal to a process or a......... kill(2) 
send a signal to a process Or ........... kill(2S) 
send mail to users or read mail ........ mail(1) 
send/cancel requests to an LP .......... Ip(1) 
SEIMVICE CAIENAAL 0.0... .cccesecencscescsececeees, calendar(1) 
set a process alarm clock alarm ...... alarm(2) — 
set and get file creation mask ........... umask(2) _ 
set and get file creation mask ........... umask(2S) 
SOUASGI -ocecuiees acnepedore crumasacgueacesccnst ascii(5) 
set environment for commana .......... env(1) 
Set file ACCESS AN, ou... eee ceeceeeew eens utime(2) 
set file-creation mode mask ...........0 umask(1) 
set of semaphores semget .............06 semget(2) 
set or shared memory id ipcrm ......... ipcrm(1) 
set process group ID setpgyp ............ setpgrp(2) 
set tabs on a terminal tabs ............... tabs(1) 
set terminal characteristics ............... stty(2S) 
set the date date 0... ee ccecsee scenes date(1) 
set the options for a terminal ............ stty(1) 
SOU THC SUIS scseccise Accasscndseasusceeoeeeesets stime(2) 
SOU TUM Cavs Sucxsseesancscassweserteawsoeeacosecsentas stime(2S) 
set user and group IDs setuid .......... setuid(2) 
set user liMits ULIMIT 0... eeeeceneeceee ulimit(2) 
setbuf, Setvbuf ...........eceeeeee edatsaudeus setbuf(3S) 
SOUTIING scsbes ces iiciatec cate anadecinevevelesrtandsuacsee setmnt(1M) 
SETIMP, LONGIMP ...........ceeeessecesenveees a. Setimp(3C) 
SCID GID sautetedexteueci denies tune detees Saseawwstec: setpgrp(2) 
setting up an environment at ............ profile(4) 
setting up an environment at ............ profile(S) 
settings used by getty gettydefs ....... gettydefs(4) . 
SQULIC: vcneesVasswssueacsucatnnartesvoonvarsanetaceves setuid(2) ? 
setvbuf assign buffering to a ............ setbuf(3S) NS 
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command programming language 

shmctl 

a message queue, semaphore set or 


get 

issue a 

issue a 

system initialization 

command programming language sh 
shared memory control operations 
get shared memory segment 

shared memory operations 

terminate all processing 

sdiff 


intrinsic function 

suspend process until 

processes kill send a 

processes kill send a 

on receipt of a system signal 

to do upon receipt of a signal 

software 

generate programs for 

troff preprocessor for drawing 

i rand 
( Fortran 
Me Fortran hyperbolic 
hyperbolic functions 

sine intrinsic function 

print section 

interval 

suspend execution for an interval 

suspend execution for interval 

for typesetting viewgraphs and 

documents, viewgraphs, and 

current user ttyslot find the 

interpolate 

SNOBOL interpreter 

file perusal filter for 


quicker 

topological 

or reject lines common to two 
binary search a 

change data segment 

brk change data segment 
terminal ct 

for eqn and neqn eqnchar 
build 

create a new 

mknod make a 
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several files or subsequent lines ....... paste(1) 
sh the standard/restricted ................ sh(1) 
shared memory control operations .. shmctl(2) 
shared memory id ipcrm remove ...... ipcrm(1) 
shared memory operations shmop ... shmop(2) 
shared memory segment shm¢et ...... shmget(2) 


shell command from Fortran sys ...... system (3F) 
shell command SySteM .............csccseeee system(3S) 
SNEWSCVIOUS DIC sccensscoseiseeesisevsvecaneesess brc(iM) 
shell, the standard/restricted ............ sh(1) 

SI CU eo cotaeuiteecrs cronies cae ctutescoraneoaees shmctl(2) 
SMM Gl aeccwsescisectcicsssnahedvotilaskeeseinsecstes shmget(2) 
SE MOD sci scs6cecoasetetendecbstwssteascecsecnasenaae shmop(2) 
SIULGOWN :ecsdacasceadshenseevsceoie eo ene shutdown(1M) 
side-by-side difference program ....... Sdiff(1) 
SIGH: OD 1OGIN: -Aciducsetiersiyetelneiesiersces login(1) 
sign Fortran transfer-of-sign ............ sign(3F) 
SIQM Al: PAUSE: sseissievscvdvecadasdsasseuiceseeceses pause(2) 
signal to a process or a group Of ..... kill(2) 


signal to a process or a group Of ..... kill(2S) 


signal specify Fortran action ............ signal(3F) 
signal specify what .............ceeeeeceeeeee signal(2) 
SiQN alS:SSIQN als s.eicserekcces le. ceeeneesevs ssignal(3C) 
simple lexical tasks lex 2.0... eeeeeeeee lex(1) 
Simple PiCtures PIC ........... ce eeeeeceeeeee ee pic(1) 
simple random-number generator .... rand(3C) 
sine intrinsic function SIN ...............06- sin(3F) 
sine intrinsic function SINN ............60. sinh(3F) 
SUV asa vei cadens ondcuuiavdesceadeceasudscteseeaannenss sinh(3M) 
sinh Fortran hyperbolic ..................8 sinh(3F) 
sizes of common object files size ..... size(1) 
sleep suspend execution for ............. sleep(2S) 
SISCD aud cosatevceaiasspaiettecooetsevatetnxsccacageurers sleep(1) 
SICOD: sancsutinsleb ces sasace tonderdig letersi oe eeaceesee sleep(3C) 
slides a troff macro package ............ mv(5) 
slides mmt typeset ......... cece eeeer eens mmt(1) 
slot in the utmp file of the ........... ttyslot(3C) 
SMOOtH Curve SPLINE ..........ceeeeeseeeceees spline(1) 
SHO: Seceoree ew ceehicsens eu weerand acevo tweceaens sno(1) 
soft-copy terminals PQ ........... sc eeeeee eee pg(1) 
software signals ssignal ...............60. ssignal(3C) 
sort and/or merge files sort .............. sort(1) 
SOP GSOU cecnca ccd doasdeecsertecietnngetesveanree qsort(3C) 
SOMCIUS OM, sscedetrsatiavictacen Cascvassvceneweesteses’ tsort(1) 
sorted files comm select ...............000 comm(1) 
sorted table DSearch .........eeeee sees eee bsearch(3C) 
space allocation Dirk ......... eee eeeseeeees brk(2) 
SPace AllOCATAION 2.1... eeeseeseeeeeseeeeeeeees brk(2S) 
spawn getty to a remote ................66 ct(1) 
special character definitions ............. eqnchar(5) 
special file MKNO 2.2... ceceeee seco ees mknod(1M) 
SOCIAL FIG: sicnter cocsanaveuiateetesessesseslons ves creat(2S) 
SOCCIAl TGs sacs csvvenescacececsanedvasusstecteres mknod(2S) 
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300s terminals 300 handle 
2621-series terminals handle 
terminal 450 handle 

make a directory ora 
format 

isatty returns a 1 if 

of a system signal signal 
of a signal signal 

by getty gettydefs 

find 

interpolate smooth curve 


context 

fsplit 

uucp 

configure the LP 

in a machine-independent fashion. 
square root intrinsic function 
exponential, logarithm, power, 
sqrt Fortran 

file number on a tape 


compatibility checker mmlint 
software signals 

scc C compiler for 

package stdio 

communication package stdipc 
_ programming shell, the 
scheduler and move requests 


get file status 

data returned by stat system call 
useful with graphical commands 
list file names and 

get file system 

ustat get file system 

print LP 

stream 

- uustat uucp 

communication facilities 

system control and 

report process 

get file 

. stat get file 

buffered input/output package 
communication package 


set time 
wait for child process to 
comparision intrinsic functions 


close or flush a 
open a 
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special functions of DASI 300 and ... 
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300(1) 
special functions of HP 2640 and .... hp(1) 
special functions of the DASI 450 .... 450(1) 
special or ordinary file mknod .......... mknod(2) 
specification in text files fspecé .......... fspec(4) 
specified file descriptor is a .............. isatty(2S) 
specify Fortran action on receipt ...... signal(3F) 
specify what to do upon receipt ....... signal(2) 
speed and terminal settings used .... gettydefs(4) 
spelling errors Spell ........... ce eseeeseeeees spell(1) 
SONS a ceasiereckecrcsaceruaeesscatensctececcasesaies spline(1) 
split a file into pieces split ................ split(1) 
SPI CSO orsctescccescosustecendyetansaueuncesectes csplit(1) 
split 77, ratfor, or eff files .............000 fsplit(1) 
spool directory clean-up uuclean ..... uuclean(1M) 
spooling system IpadmMin .............cce0 lpadmin(1M) 
sputl access long integer data ......... sputl(3X) 
SQGUFOMlAN esse sciccserttadesiccceteeteaseces sqrt(3F) 
Square root FUNCTION EXP .........eeeceeee exp(3M) 
square root intrinsic function ........... sqrt(3F) 
srcheof position to a specific ............ srcheof(2S) 
Sroff format text ..............ccsececeecseeseeeee SFOFF(1) 
sroff/MM nroff/MM document ........... mmilint(1) 
SSIGI Al: sesvedecersecdtctsceokssavscueesbeueswestseee ssignal(3C) 
Stand-alone PrograMs. ...........sscneeceees scc(1) 
standard buffered input/output ........ stdio(3S) 
Standard iNterpProceSs. ..........ssscesseceees stdipc(3C) 
standard/restricted command ........... sh(1) 
start/stop the LP request ..............000 lpsched(1M) 
Stat get file StatuS .......... ee ceeeseeneeeee stat(2S) 
SUL acs deistiecwecesnasesonasconcnssewsdecaseceties iesest stat(2) 

SUG 5 Sis vavisre vad aes autocad woea ee cecevs uovanaeesesaus stat(5) 
Stat. statistical NeEtWOrk ............csscceees stat(1) 
Statistics for a file system ff ............... ff(1M) 
StatiSticS UStat ........... ce eeecseseseceeecevenes ustat(2) 
STATISUICS: ansebiastenetiysiewsitenlescacseeskvceesens ustat(2S) 
Status information Ipstat ................06 Ipstat(1) 
Status inquiries ferror ..............sseeecee-- ferror(3S) 
Status inquiry and job control .......... uustat(1) 
status ipcs report inter-process. ....... ipcs(1) 
StAtUS PFOGFAM ...........cecescesscssceneeseeces sys(1M) 
SUQlUS OS si cesiuce sti es deed seibicescasdetenssiveses ps(1) 
StAtUS Stal sscicsetscs devecernive seasavbanecdewoacens stat(2) 

STA LUS -ocsaicaness péannsvaceavesuteceas saumeeeweneeneaas stat(2S) 
SIGIO-StANG AIG: siesisesasscedasansverssekiowtesis stdio(3S) 
stdipc standard interprocess ........... stdipc(3C) 
StiMe Set TIME .......... ce eeceeesececeeseeneeees stime(2S) 
SUNG ckducecavacdss dvs ivedutueceuddecniesseSanweacsse stime(2) 
stop or terminate wait ............ceeeeeeee wait(2) 
SUGIND: SUNG asiccicsccivecdate xesvensioesevevencs strcmp(3F) 
Stream editor SE ............ccesecescnececeees sed(1) 
SUVEAM 1ClOSC cies ddecsdiantdecceseuiedscciuees fclose(3S) 
SITEAM TODCH:. cecdei scene disexcatwcesseetedscstaese fopen(3S) 
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reposition a file pointer iN a StreaM fSCEK oui... eecccsseceesecesseeeoees fseek(3S) 
get character or WOrd from a StPEAM Get .........eeseeceescececcsnsceeeeeeeees getc(3S) 
get a String frOM A StFEAM GetS oui... eccceeeseceseenecsccersees gets(3S) 
put Character Or WOT ON A  StFEAM PUC ou... ceecessccesceecceeereceseneeees putc(3S) 
Dut a StrING ON A STFEAM PUtS 2... ceseceseeecnsseececceccens puts(3S) 
assign buffering to a_ stream setbuf, setvbuf ........... cs seeseees setbuf(3S) 
stream status inquiries ferror ............ ferror(3S) 
push character back into input StreaM UNGETC ..........ceeccsecesesescesccecooes ungetc(3S) 
ftIMSP streaming cartridge controller .......... ft(7) 
long integer and base-64 ASCII string a64l convert between ............. a641(3C) 
functions strcmp = string comparision intrinsic .............. strcmp(3F) 
convert date and time to String CtIME ...... eee eee cceeecentseceeeensens ctime(3C) 
convert floating-point number tO String CCVE ...... ce eesecceseceeeteececseceesenes ecvt(3C) 
geta_ string from a stream Gets ..............e0 gets(3S) 
return length of Fortran String eM ou... cecencesececesccececceenoes len(3F) 
puta. string on a Stream puts ....... eee eee puts(3S) 
strtod convert string to double-precision number ... strtod(3C) 
convert string to integer Strtol ..............csseeeeees strtol(3C) 
SIPING: ODELFAatiONS. —StHIAG ccsesccdiceccssiecercossnscecsddcncsvcsvessestescs string(3C) 
gps graphical primitive string, format of graphical files ........ gps(4) 
find the printable strings in an object, or binary, file .. strings(1) 
information from a common strip symbol and line number ........... strip(1) 
String to double-precision number StrtOd CONVESE ..........ccecseseeeewesoeseeeseees strtod(3C) 
convert string to integer StrtOl oo... cccsseeececeeccencceeeens eeusteue strtol(3C) 
processes using a file or file structure fuser identify ............cccsssceee fuser(1M) 
characteristics stty Set terminal .............ccccscsccccnscnceees stty(2S) 
set the options for a terminal  Stty 20... eeccscesetercsscceccscescesceccnssoees stty(1) 
become super-user or another user SU ............c08 easiaqiceyiacuseieetueeusasaveow Sees staxe su(1) 
graphics interface sSubroutineS Plot ...........ccsseeecseescees plot(3X) 
same lines of several files or subsequent lines of one file .............. paste(1) 
return location of Fortran Substring index ...............ccccescsaccseseeees index(3F) 
and block count of a file sum print checksum ..................sec000 sum(1) 
summarize disk uSage AU ............0000 du(1) 
du summarize diSk USAGE .............ceeceeeee du(8) 
accounting records command summary from per-process. ...........006- acctcms(1M) 
update the super DIOCK SYNC .........cccecesensecescnsenees sync(1) 
update Super-DlOCK SYNC ...........ccccseeeeecsseeenees sync(2) 
| become super-user or another user Su .......... su(1) 
document analyze surface characteristics Of a .........0. style(1) 
interval sleep suspend execution for aN ..........eeeeeee sleep(1) 
sleep suspend execution for interval ......... sleep(2S) 
sleep suspend execution for interval ......... sleep(3C) 
pause suspend process until signal ............ pause(2) 
SWaD DYVIES: ~SWAD oi cdicocscacsosdsencesvassucasoscunedevocceasvees swab(3C) 
SWAP SWAP COVICE ..........--ccecscssececesscecssenstons swap(/) 
information from a strip symbol and line number .............0cc00 strip(1) 
file symbol table retrieve symbol name for common object ..... Idgetname(3Xx) 
name for common object file symbol table entry Idgetname ........... Idgetname(3X) 
object compute the index of a symbol table entry of a common ...... Idtbindex(3X) 
object file read an indexed symbol table entry of a common ....... Idtbread(3X) 
common object file symbol table format syms ..............0.. syms(4) 
file Idtbseek seek to the symbol table of a common object .... Idtbseek(3X) 
object file symbol table format SYMS COMMON ou... cieecescsccseccssceseeseees syms(4) 
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update super-block 
call another UNIX 
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command; report process data and 
daily/weekly UNIX system file 
data returned by stat 
exercise link and unlink 
checkall faster file 
UNIX-to-UNIX 

interactive repair fsck file 
interactive repair fsck file 

file ioctl.syscon 

sys 

UNIX system to UNIX 

what to do when the 
primitive 

file 

fsdb file 


names and statistics for a file 
public UNIX-to-UNIX 

filesave daily/weekly UNIX 
examine 

scripts brc 

configure the LP spooling 
interactive message processing 
construct a file 

mount and dismount file 
mount a file 

operating 

incremental file 

Fortran action on receipt of a 
get file 

uStat get file 

mounted file 

UNIX 

unmount a file 

print name of current UNIX 
get name of current UNIX 
format of 

who is on the 

mount a file 

issue a shell command 

a shell command from Fortran 
dcopy copy file 

checklist list of file 

volcopy copy file 

binary search a sorted 

_ for common object file symbol 
compute the index of a symbol 
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SYNC ec taseatec oesersteee eae eea rea tiaiees sync(1) \ —. 
SVG ace shacsccsectuicieseudsnueianacuseenetaseor ees sync(2) = 
SVSUOI i cess2ieecctcsstedsasseessnerace eesteenecntes cu(1C) 
system activity graph Sag .........ccccsee sag(1) 
system activity report package ......... sar(1M) 
system activity report sail ................ sail(1) 
system activity timex time a .............. timex(1) 
system backup fileSave ..............cee eee filesave(1M) 
SYSTEM Call Stat ........... ccccececscscseececenes stat(5) 
System Calls LINK oo... kc ce scence eeee link(1M) 
system checking procedure ............0. checkall(1M) 
system command execution uux ...... uux(1) 
system consistency check and ......... fsck(1M) 
system consistency check and ......... fsck(8) 
system console configuration ........... ioctl.syscon(4) 
system control and status program .sys(1M) 
SYSTEM COPY UUCP qu... cccecececsccsssoesecees uucp(1) 
system crashes crash. ............. eietiees crash(8) 
system data types types ....... eee eeee types(5) 
system debugger fSdb ..........eeseeeee eens fsdb(1M) 
SySteM GEDUGGE! ...........ccescscerceeeseecees fsdb(8) 
system error messages perror .......... perror(3C) 
System ff list file ............ccecsccereeeeecees ff(1M) 
syStem file COPy UUTO ......... settee eee eees uuto(1) 
system file system backup ................ filesave(1M) oan 
SYSTEM IMAGES CIASN ..........cceeseeeeeeeeee crash(1M) o 
system initialization shell .............6. brc(1M) a 
SYSTEM IPACAMIN ......... ccc cee ee sec eseeceeeees lIpadmin(1M) 
SYSTSIM IMAIUX asics csicsccasscecsvaccscernvesseien mailx(1) 
SYSTEM MEFS ........ceccsccecsecsccsccecesencenaces mkfs(1M) 
SYSTEM NIOU NE scseccsesissncdeccdecivacecsswaceseas mount(1M) 
SYSTEM MOUNT ........ccceseecsceceees aivagvecivs mount(2) 
system profiler profiler .............:ssscecees profiler(1M) 
SYSTEM TESIOlS vcciscenciensecvesevsvesesecsceces restor(1M) 
system signal signal specify ............. signal(3F) 
system StatisticS UStat ............ cece eens ustat(2) 
SYSTEM StatiStiCS .......... cc eeeeseserenevecees ustat(2S) 
system table mnttab ........ eee mnttab(4) 
system to UNIX system copy uucp ... uucp(1) 
SYSTOM UMOUNT sciceiccratnainecedsaateeapentes umount(2) 
SYSTEM UN AME ........cccccecscsecsceccesccesces uname(1) 
SYSTEM UN AME ...... cc cececsceccceecscsseescncces uname(2) 
SYSTEM VOIUME FS ........cececeescsseccenseosres fs(4) 
system Who ..........066 paaasvsebeycsceheandecsas who(1) 
SEVS (CI: cosiietssadrecetvacass cteanaessesateeesecnen mount(2S) 
SVSTOIN: ces cus ciuccancustancdusicaussbuneebacnsvenereies system (3S) 
SYSICMT: ISSUC: sisasescsdacdecadssccersaneserautuseens system (3F) 
systems for optimal access time ....... dcopy(1M) 
systems processed by fsck ............4.. checklist(4) 
systems with label checking ............. volcopy(1M) 
table DS@arch ...........cccsesccesceescteeecerses bsearch(3C) — 
table entry Idgetname name ............. Idgetname(3X) / : 


table entry of a common object ........ Idtbindex(3X) 


ea 
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file read an indexed symbol 
common object file symbol 
mounted file system 
Idtbseek seek to the symbol 
graphical 

establish mount 

tbl format 

manage hash search 

set tabs on a terminal 
deliver the last part of a file 
Fortran 

tangent intrinsic function 
fbackup make a fast 
fobackup make a fast 

make an image copy of a 
crm caching reel-to-reel 
rrm raw reel-to-reel 


dump incremental dump 
recover files from a backup 
tape file archiver 

programs for simple lexical 
troff 

deroff remove nroff/troff, 


of a file pointer 

create a 

create a name for a 

format of compiled term file 
conventional names for terminals 
data base 

paginator for the TEKTRONIX 4014 
special functions of the DASI 450 
EOT on the other 

termcap 

terminfo 

gtty get 

stty set 

vconfig virtual 

spawn getty to a remote 
generate file name for 

select 

routines termlib 

tty general 

establish an out-going 

gettydefs speed and 

set the options for a 

set tabs on a 

get the name of the 

find name of a 

ttytype data base of 

functions of DAS! 300 and 300s 


of HP 2640 and 2621-series 
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table entry of a common object ........ Idtbread(3X) 


table format SYMS ..........cccceeeeceeeseetee ee syms(4) 
TaDlO MNHAD -ccccé tease sibiccesecutadindenstanesce mnttab(4) 
table of a common object file ........... Idtbseek(3X) 
table of contents routines toc ........... toc(1) 
TADlO SOU a iessceaciserseoeelcdesedneetiace: setmnt(1M) 
tables for nroff or troff ...... eee tol(1) 
Tables MSCAICHI ciicceisisdscdsescndescacareseress hsearch(3C) 
TADS Socrates seer comenievisxese se deavens besa teateseraes tabs(1) 
RAI: scala idenouelececsweven seve ssaccauseuue nsetudeswunys tail(1) 
tangent intrinsic function tan ........... tan(3F) 
tanh Fortran hyperbolic .................... tanh(3F) 
tape backup of a file system ............. foackup(1M) 
tape backup of a file system ............. fbackup(8) 
1¢-1 0{= 9k ole) ©)\, ¢: | ©); ee 
TADS CFIVEM: cevasacvicssaucoeawanctetsvacessunctaress rm(/) 
TADS GIVER: wessesraivccsescsscsaleisseceecpces tee ee rm(7) 
tape file archiver tar oo... ee eee seen tar(1) 
TADO TOMA ccccacsacsi siete cs tetaceracaieiencectc? dump(4) 
TADS TCC. costceseseerealcawencnatediecasteserscaes frec(1M) 
WAG Sec soiaes evs tesiies ween csecncecededenneueeacess tar(1) 
tasks lex Generate ...........ccceeseceeeeeeees lex(1) 
tbl format tables for nroff or ............. tbl(1) 
tbl, and eqn constructs .......... eee deroff(1) 
tc troff output interpreter ................... tc(1) 
tell report the current value ............... tell(2S) 
temporary file tmpfile 2.0... eee tmpfile(3S) 
temporary file tmpnam ............ ee eeeee tmpnam(3S) 
MOT IV: ceecceescdasecuuesccter se cleveebateeeGiuecntscteem term(4) 
LOUD Seveiccevecinles ouedeuswunassexstensvecsancsucesteos term(5) 
termcap terminal capability .............. termcap(4) 
TEPIMIN Al SO 14 soho cscs Sessccendecccenstestavees 4014(1) 
terminal 450 handle ............. cesta uae 450(1) 
terminal and exits. write ................06. write(1) 
terminal capability data base ........... termcap(4) 
terminal capability data base ........... terminfo(4) 
terminal characterisitcs ...............0.c08 gtty(2S) 
terminal characteristics ..............cccceee stty(2S) 
terminal Configuration ...............seeeeeee vconfig(1M) 
ROP IID ALC sii ceerp vat vavecnascecndseconacoreceosa: ct(1) 
terminal CtErMid ..........ceeeseeseeececeeees ctermid(3S) 
terminal filter Qreek ......... eee c cece wees greek(1) 
terminal independent operation ....... termlib(3C) 
terminal interface ..........e ce eccee ee ee sees tty(7) 
terminal line connection dial ............ dial(3C) 
terminal settings used by getty ......... gettydefs(4) 
LELIMMITV AL SULY coccevddeceaasscawacds devisees wiextanxe stty(1) 
TEKMIN AITADS: sei vicceseckstavewtiacecesevibsda tabs(1) 
TSHIMIN Al TY es ea ateaoeatcot see wees tty(1) 
terminal ttyNaAMe ..........eecescesccseseeees ttyname(3C) 
terminal types by port .......... eee eees ttytype(5) 
terminals 300 handle special ........... 300(1) 
terminals hp special functions. ......... hp(1) 
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file perusal filter for soft-copy 
conventional names for 


shutdown 


exit 

daemon errstop 

wait for child process to stop or 
query 

terminal capability data base 


operation routines 
command 


condition evaluation command 


casual users edit 

change the format of a 
format specification in 

eqn format mathematical 
ocw prepare constant-width 
troff 

nroff format or typeset 

sroff format 

lock process, 


wump 
terminfo compiler 


data and system activity timex 
update access and modification 
set file access and modification 
get process and child process 
process data and system activity 
create a temporary file 

a name for a temporary file 
initiate pipe 

table of contents routines 


merge or add 

and modification times of a file 
graphics filters 

query terminfo database 
translate characters 

process 

function sign Fortran 
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terminals pg 
terminals term 
terminate Fortran program abort 
terminate a process kill 
terminate all processing 
terminate process exit 
terminate process 
terminate the error-logging 
terminate wait 
terminfo compiler tic 
terminfo database tput 
terminfo 
termlib terminal independent 
test condition evaluation 
test your knowledge quiz 
test 


text file newform 
text files fspec 
text for nroff or troff 
text for otroff 


text 
text 
text, or data in memory plock 


enseeeveesacese 


Seesesensevosenovecsoeess 


aeesvasoaes 


the C language preprocessor cpp .... 


the game of backgammon back 
the game of black jack bj 
the game of craps craps 
the game of hunt-the-wumpus 
the null file null 


tic 


time a command; report process 
times of a file touch 
times utime 
times 
timex time a command; report 
tmpfile 
tmpnam create 
to/from a process popen 
toc graphical 
topological sort tsort 
topq prioritize print queue 
total accounting files acctmerg 
touch update access 
tplot 


trace ptrace 
transfer-of-sign intrinsic 


eeacces 

eveetaaresessasete 
eeeesesvenerssesense 
eeevenzece 
PSeselCeGTHKesFoveseaessesotesveneseen 
PSSASHSEKSHSHHSSSSSESSSHHHEHTHESSHSSESOREHSSHLEHSHELSERELELE 
Seeeseesecacartesseseeve 
eacece 
Seeassocoeneseesenesevevesoe 
SCECHSHEHHSEFHADHOHRSESEHEHREESOHOHSEEE SEES 
SSOSSHHRHSEHSSESSSHEHCEHRHCHAEHREHKSESHEHHOKREHOHSEROBH AEE 
eeensecece 
SSSHSOHHESSSEESHOTSHHOSHOHELEEOEETETEHMOLELEEOEESE 
SOCasF Ses evesvoessesereeeseesseonveses 
BOseeceonssevenerece 
SCeOeeecseosegeseesaeseneesseseagsesessenae 


seseecce 
SCeevenesteseseonseseesaven 

BOSCH HRSHSSHESAOHHESGEFHEHEHSHHHSHEEBELECBAETH OHO ZSOe 
SCORSSCCLOCEASSSHEHES STORES ETHAEHEEDSSERLSHSOBeeEE DOOD 
SFCOCHSAOHHSHSHEHSHSSSHESSTETSSEHREHEKRHSHH PRES UeeHeEAsaeseaene 
SPARSSSTHRAHHHEHERES HHH SEEE RESET H ESE TAAES 
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pg({1) 
term(5) 
abort(3F) 
kill(1) 
shutdown(1M) 
exit(2) 
exit(2S) 
errstop(1M) 
wait(2) 
tic(1M) 
tput(1) 
terminfo(4) 
termlib(3C) 
test(1) 
quiz(6) 
test(1) 
ed(1) 

ex(1) 
edit(1) 
newform(1) 
fspec(4) 
eqn(1) 
ocw(1) 
troff(1) 
nroff(1) 


. sroff(1) 


plock(2) 
cpp(1) 
back(6) 
bj(6) 
craps(6) 
wump(6) 
null(7) 
tic(1M) 
time(1) 
timex(1) 
touch(1) 
utime(2) 
times(2) 
timex(1) 
tmpfile(3S) 
tmpnam(3S) 
popen(3S) 
toc(1) 
tsort(1) 
topq(1M) 
acctmerg(1M) 
touch(1) 
tplot(1) 
tput(1) 
tr(1) 
ptrace(2) 
sign(3F) 
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system uucico file 

walk a file 

manage binary search 
trigonometric functions 
language 

9700 printer dx9700 prepare 
typesetting viewgraphs mv a 
tc 

simple pictures pic 
typesetting 

tbl format tables for nroff or 
mathematical text for nroff or 
files for device-independent 
provide truth values 

manage binary search trees 
topological sort 

get the name of the terminal 
genera! terminal interface 
find name of a terminal 

the utmp file of the Current user 
types by port 

explicit Fortran 

determine file 

primitive system data 

and slides mmt 

nroff format or 

mv a troff macro package for 
troff text formatting and 

get and set user limits 
creation mask 

set file-creation mode mask 


unmount a file system 

print name of current UNIX system 
get name of current UNIX system 
rdsk raw 

a previous get of an SCCS file 
character back into input stream 
pseudo-random numbers generate 
report repeated lines in a file 
make a 

conversion program 

exercise link and 

remove directory entry 


umount 

suspend process 
times of a file touch 
linear search and 
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translate characters CONV ...........c0008. conv(3C) 
translate Characters tr .........ccccceeeeseees tr(1) 
transport program for the uucp ....... uucico(1M) 
RCS 4 oiwsccitan Sacto eenapealocsentesenddetasetyetes ftw(3C) 
1KEOS ASCALCH  scccii cs assecdaeecuhecsnesseietossas tsearch(3C) 
UGG) adeaassceeesci ci tasbawenct shee cavaniwadeunacen ene trig(3M) 
troff description of output ................. troff(5) 

troff documents for the Xerox ........... dx9700(1) 
troff macro package for ...............0600 mv(5) 

troff output interpreter ........ eee tc(1) 

troff preprocessor for drawing .......... pic(1) 

troff text formatting and ............... eee troff(1) 

TCOUM coe coschoaete soueetesuatasseeenecsneicewsasvacodess tbl(1) 

troff CQn FOFMAL ........eeeecesseeceecesceces eqn(1) 

troff font description ............. font(5) 

TRUGs ssesecsccatacuewiesccsesvatacsicareestecntocaccicaees true(1) 
TSANG: fiiessd tcaeccsedecsboren chee euv ede iwhveneecte tsearch(3C) 
NSOUM: sousncis na raecsGenanenseserecoaseceescatte.weneeeas tsort(1) 

HI i doaccensdocters ticccemasas bogs sacturesnieces: tty(1) 

CY esc ec ee eee ees aee tty(7) 

TEV ATIIE 5 isi sisndeccncdcuesasersactuouundsedavaesees ttyname(3C) 
ttyslot find the SlOtIN ............eeeeeeees ttyslot(3C) 
ttytype data base of terminal ............ ttytype(5) 
type CONVErSION ftyPe ........... eceeeeeeeees ftype(3F) 
1] 91520 ||| > amen SER ene nner ent Det Te file(1) 

LDCS AV DCS visaccteareteccteieseneuasenets types(5) 
typeset documents, viewgraphs, ...... mmt(1) 
TYDESER TOK coi iigcccteisodecd canecgesceevpeareees nroff(1) 
typesetting viewgraphs and slides ... mv(5) 
tyPESettiNG .........cesseeeseeeseeee as tloade sete troff(1) 
MRITEIA UL, Ssh casctee rset Codasacaeaseecasysaaabaueieedieaens ulimit(2) 
umask set and get file ..................ecee umask(2S) 
UV ASK recente antes cavevee ics weceac sean eleeecivenwves umask(1) 
umount unmount a file system .......... umount(2S) 
CUIYOUNIE, tadscsceewecsccsesseeetanscetceeseseseeevess umount(2) 
REV AIS: Sec cicceweredanbanstaneveceisesseactedeaaausmes uname(1) 
CIV AIG eectenssusitecaneccedeapsvekscsdekasabwat ceases uname(2) 
(unbuffered) version of dsk .............08. dsk(7) 
UNROQGt UN Oc Ae car eccevcavnes eeceteccccscasecew: unget(1) 
UNGEIC: DUSTY s6)iscsccesevecswaxcasceteuctsiwices ungetc(3S) 
uniformly distributed oo... eee eens drand48(3C) 
Gos os caronnlackieacsec art (estos scanoutsesessneeeaec uniq(1) 
unique file name mktemp ..............006 mktemp(3C) 
CIES 5 s5scco sce sa necadsenvias sevanieraeetaunmetaedert units(1) 
unlink system calls link oo... link(1M) 
CINK steal cote cae cancedsneaccavensdlamaceseuattecte unlink(2) 
unmount a file system umount .......... umount(2) 
unmount a file SyStEM ou... eeeeeee eens umount(2S) 
-UNTIT Signal PAUSE ...... cette eee ee eens pause(2) 
update access and modification ...... touch(1) 
UPAate ISSAIChH  scssivedvisidelevecedevedvcdsad lsearch(3C) 
update super-block SYNC ..........ceeceeee sync(2) 
update the super block sync ............ sync(1) 
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programs make maintain, 

specify what to do 

summarize disk 

du summarize disk 

stat statistical network 

generate disk accounting data by 


print. 


set 
get character login name of the 


get and set 

return login name of 

become super-user or another 
in the utmp file of the current 
getuid get real and effective 
group get real user, effective 
send mail to 

write to all 

editor (variant of ex for casual 
fuser identify processes 
statistics 

get file system statistics 
graphical 

identical mirutil 

access and modification times 
utmp 

access 

ttyslot find the slot in the 

for the uucp system 

uucp spool directory clean-up 
monitor 

control uustat 

file transport program for the 
UNIX system to UNIX system copy 
encode/decode a binary file for/ 
Status inquiry and job control 
monitor uucp network 
UNIX-to-UNIX system file copy 
system command execution 
requests 

_bdrdrst reset the 

vcpdmp dump contents of 
validate SCCS file 


return integer absolute 
Fortran absolute 

return 

ceiling, remainder, absolute 
tell report the current 
change or add 

provide truth 
machine-dependent values 
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update, and regenerate groups Of .... 


make(1) 

upon receipt of a signal signal ......... signal(2) 
USAGC GUY ciocsse diladesessrsnddsonreeceteestan du(1) 
US AOC Gai eesicsicscasiccechaveeucnavavccausnesadacerdeens du(8) 
useful with graphical commands ..... stat(1) 
user ID diskuSg diSkUSG  ............sse00 diskusg(1M) 
user and group IDs and names id .... id(1) 
user and group IDs setuid ................ setuid(2) 
user crontab file crontab ..............000 crontab(1) 
LEISOD (CUSETIC) ciccosccstencavecssaaieedeasecaduswseen cuserid(3S) 
user environment ENVIFON ..........cceeeee environ(5) 
USEF LIMITS ULIMIt ........ceeceeecenceenceeees ulimit(2) 
USEF IOQNAME ci cccécéccccveccssiacecedexcsasesses logname(3xX) 
USCE SU cess lip desaleccctts case ctdiaeeesewant cesses su(1) 
user ttyslot find the slot ................... ttyslot(3C) 
user, and real and effective .............. getuid(2S) 
user, real group, and effective .......... getuid(2) 
users or read mail Mail ...........cececeeee mail(1) 
USEIS Wall) scctscccecceccssessacescssnseveearsescesen walli(1M) 
MISEIS) CGIU EK: sinsdedccsieeccctetsceusdesscacees edit(1) 
using a file or file structure ............... fuser(1M) 
uStat get file SYSTEM ............ecsscssscescees ustat(2S) 
UIST AU esis ccc ve eaise aan vone iossnacveeMarseeoesasotest ustat(2) 
UtItES QUEM -covcccccsececuicdesasccseesvesexesseres gutil(1) 
utility for Connecting tWO ........... eee mirutil(1M) 
WItIMG: SOU TNC: vasiiesens sucscvceceswasencwadesaseteas utime(2) 
utmp and wtmp entry formats .......... utmp(4) 
utmp file entry Getut .........ssecccsseceseeees getut(3C) 
utmp file of the current user .............. ttyslot(3C) 
uucico file transport program ........... uucico(1M) 
UO GIO AD apse sccalaciusdus Sox euererensuadoeneadenese uucilean(1M) 
UUCP NETWOTK UUSUD .......cccrenssseeeoeees uusub(1M) 
uucp Status inquiry and job ............. uustat(1) 
UUCP SYSTEM UUCICO .......ccssceseecscercoes uucico(1M) 
WUC svc cwederocisexteantwasanysiusanonacaosesenteseseee uucp(1) 
UUCN COE, UUGECOCE .......cecccececceceseveee uuencode(ic) 
GUSTAC UGC uses cirecstanneusletdeseatasacsiereus uustat(1) 
USUI, cesisccaccsekus casa sesaucoocaccreisvettinetaass uusub(1M) 
UUTO PUDDING: sco isiacissecisdermuseaeianseaasen uuto(1) 
UUX UNIX-to-UNIX 20... ce ccsseccceeenerees uux(1) 
uuxqt execute remote commancd ...... uuxqt(1M) 
VCP CORTIONER ccssedecenecvatincensavececden brdrst(1M) 
VMEbus Communication Processor’s vcpdmp(1M) 
WAl -schausencawGucadacaedawatyuudantasddeausaves saesensen val(1) 
validate SCCS file val... eeceseeeeees val(1) 
VAIS ADS <ccdiescuesddcctacosevesdetvapantucasouse abs(3C) 
VW AIC ADS sccscuicsivevel Givedsencaaeceetacnsencances abs(3F) 
value for environment name getenv . getenv(3C) 
value functions floor floor, ................ floor(3M) 
value of a file Pointer oo... tee eeeeee ees tell(2S) 
value to environment putenv ............ putenv(3C) 
VAIN CS EUG: sccdinsdecesdevansuccnaatasswece axetuaws true(1) 
WAIUGS: as .cacstnucerccsveshassecsanseaaaxcseawasedusns values(5) 
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( | print formatted output of a 
. handle variable argument list 
return Fortran environment 

version control 

virtual terminal configuration 
Communication Processor’s 

get option letter from argument 


get a 
compare two 

display editor based on ex 

mv a macro package for making 
troff macro package for typesetting 
mmt typeset documents, 

vconfig 

file systems with label checking 
format of system 

output of a varargs argument list 
terminate wait 

await completion of process 


write to all users 
word count 
crashes crash 


( ' who is doing what 
al profile 


get character or 

guess the 

put character or 

find hyphenated 

change 

change 

get path-name of current 


chdir change 
write 
putpwent 


write on a file 

on the other terminal and exits. 

open for reading or 

open for reading or 

file regions for reading or 

utmp and 

the game of hunt-the-wumpus 

for the Xerox 9700 printer 

list(s) and execute command 

ee yacc 


( oa Ny 
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varargs argument list vprintf ............ vprintf(3S) 
VALOIS wesics lec piadelseseeeiceecctwseeaese sae suseets varargs(5) 
Variable GeteNnv ou... ceeeseceseeeeeeseeeeee getenv(3F) 
WGC arcsec duaisestuctenacnnedsdscenanbenanieensqeussccuse vc(1) 
VCORTG coolssulvscceesecodiestsessae eee ete vconfig(1M) 
vcpdmp, dump contents of VMEbus vcpdmp(1M) 
VECTOr GEtOPt ........ccceeeeccnceeeereneereceenees getopt(3C) 
verify program assertion asserft ........ assert(3X) 
VETSION CONTIO! VC .......ccccccnceceteccecsseees vc(1) 
version of a SCCS file get ................. get(1) 
versions of an SCCS file sccsdiff ...... sccsdiff(1) 
vi screen-oriented (visual) ................. vi(1) 
VIEW “CFA ONS -sccsrcvass cccncdinceteiveasivedssades mv(/) 
VIEWOFAPNS ANA MV ........ceseceensceeeeeees mv(5) 
viewgraphs, and slides .................... mmt(1) 
virtual terminal configuration ............ vconfig(1M) 
VOIGODY CODY sucecceadencdovesscsvevseavndonvnins voicopy(1M) 
VOIUIMVG TS: = ccancvceciesvaccceudbocseealncccuseeeens fs(4) 
vprintf print formatted ..........eeeeeees vprintf(3S) 
wait for child process to stop or ...... wait(2) 
Weal U uvncuatanedenanevecis csatieca Gece uascacs cass eseaers wait(1) 
walk a file tree ftw ...........scsccesceseeeeeeees ftw(3C) 
WAIL oii sccedaivstasceuceseceececcectascrcessocees cen wall(1M) 
WC eas oie ii ia ce ade eousbaseuasiumabuewedotosweualaedinees wc(1) 
what to do when the system ............. crash(8) 
who is on the system WHO ...........ccee0 who(1) 
WOOO caetetas tell aiioctuirehuservesitensadassuseass whodo(1M) 
within a fUNCtION PIOf ........ eee teeeeee prof(5) 
WOFrd COUNT WE dicccheniiccch eh icisrescehiavenss wc(1) 
word from a stream getc ................00 getc(3S) 
WOI NANGMAN ..........ceceesceeceeceesceeeoees hangman(6) 
word On a StreaM PUtc .........ceeceeeeeees putc(3S) 
WOIGS NY DNON: stvssevecosietsveioesseessucestee hyphen(1) 
WOrKING GireCtOry CC .......ceeeseeesseeeeees cd(1) 
working directory CHIN ........cseceeeeeeees chdir(2) 
working directory getcwd ............00000- getcwd(3C) 
working directory name pwd ............ pwd(1) 
WOFKING CIFECtOFy ..........ceseececsscscesecsees chdir(2S) 
WIite ON A FIO 0... sccesenecceswescceeecees write(2S) 
write password file entry ...........cceesees putpwent(3C) 
write to all users Wall oo... eeecssesseeees wall(1M) 
WEG docpcceuestcsat stron duce cacseeestaceale ceveeeors write(2) 
WHITE BOT: sactosscccdees volasvancaoeuzsasevercseree write(1) 
WHUNG ODEN sccssasvatscanctonis soscassconteevensed open(2) 
WHITING iu sucichass counavendwuipaas teaseceneenees open(2S) 
writing provide excluSive ...............0 lockf(2) 
wtmp entry formats UtM) .........ssseeeees utmp(4) 
WET Ds cacvaxt cucusdeccasecvacecsesuataseseedouncent wump(6) 
x9700 prepare nroff documents ....... x9700(1) 
xargs construct argument ............668 xargs(1) 
yet another compiler-compiiler .......... yacc(1) 
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NAME 
intro — introduction to commands and application programs 


DESCRIPTION 
This section describes, in alphabetical order, publicly-accessible 
commands. Certain distinctions of purpose are made in the head- 
ings: 
(1) Commands of general utility. 
(1C) | Commands for communication with other systems. 
(1G) | Commands used prinvarily for graphics and computer-aided 

design. 


COMMAND SYNTAX 
Unless otherwise noted, commands described in this section accept 
options and other arguments according to the following syntax: 


name [option(s )]| [cmdarg(s)] 


where: 
name The name of an executable file. 
option — noargletter (s ) or, 


— argletter <> optarg 
where <> is optional white space. 


noargiletter A single letter representing an option without an argu- 


ment. 

argletter A single letter representing an option requiring an 
argument. 

optarg Argument (character string) satisfying preceding 
argletter . 

cmdarg Path name (or other command argument) not begin- 
ning with — or, — by itself indicating the standard 
input. 

SEE ALSO 

getopt(1). 

exit(2), wait(2), getopt(3C) in the Sys5 UNIX Programmer Reference 

Manual. 


DIAGNOSTICS 
Upon termination, each command returns two bytes of status, one 
supplied by the system and giving the cause for termination, and (in 
the case of “normal” termination) one supplied by the program (see 
wait (2) and exit (2)). The former byte is 0 for normal termination; 
the latter is customarily 0 for successful execution and non-zero to 
indicate troubles such as erroneous parameters, bad or inaccessible 
data, or other inability to cope with the task at hand. It is called 
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variously “exit code”, “exit status”, or “return code”, and is 
described only where special conventions are involved. 


BUGS 
Regretfully, many commands do not adhere to the aforementioned 
syntax. | 


WARNINGS 7 
Some commands produce unexpected results when processing files 
containing null characters. These commands often treat text input 
lines as strings and therefore become confused upon encountering 
a null character (the string terminator) within a line. 
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NAME 
300, 300s — handle special functions of DAS! 300 and 300s termi- 
nals 


SYNOPSIS 
300 [ +12] [-—-n][-—dt,l,c ] 


300s [ +12] [-—-n ] [ -d tlc | 
300S [ +12] [ -n ] [ -d tlc ] 


DESCRIPTION 

The 300 command supports special functions and optimizes the use 
of the DAS! 300 (GS! 300 or DTC 300) terminal; 300s performs the 
same functions for the DAS! 300s (GS! 300s or DTC 300s) terminal 
It converts half-line forward, half-line reverse, and full-line reverse 
motions to the correct vertical motions. It also attempts to draw 
Greek letters and other special symbols. It permits convenient use 
of 12-pitch text. It also reduces printing time 5 to 70%. The 300 
command can be used to print equations neatly, in the sequence: 


nean file ... | nroff | 300 


WARNING: if your terminal has a PLOT switch, make sure it is turned 
on before 300 is used. 


The behavior of 300 can be modified by the optional flag arguments 
to handle 12-pitch text, fractional line spacings, messages, and 
delays. | 


+12 permits use of 12-pitch, 6 lines/inch text. DAS! 300 termi- 
nals normally allow only two combinations: 10-pitch, 6 
lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12- 
pitch, 6 lines per inch combination, the user should turn 
the PITCH switch to 12, and use the +12 aption. 


—n controls the size of half-line spacing. A half-line is, by 
default, equal to 4 vertical plot increments. Because each 
increment equals 1/48 of an inch, a 10-pitch line-feed 
requires 8 increments, while a 12-pitch line-feed needs © 
only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of sub- 
scripts and superscripts. For example, nroff half-lines 
could be made to act as quarter-lines by using -—2 . The 
user could also obtain appropriate half-lines for 12-pitch, 8 
lines/inch mode by using the option -3 alone, having set 
the PITCH switch to 12-pitch. 
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—dt,/,c controls delay factors. The default setting is -d3,90,30 . 
| DAS! 300 terminals sometimes produce peculiar output 
when faced with very long lines, too many tab characters, 

or long strings of blankless, non-identical characters. One 

null (delay) character is inserted in a line for every set of t 

tabs, and for every contiguous string of c non-blank, non- 

tab characters If a line is longer than / bytes, 1+(total 


length)/20 nulls are inserted at the end of that line. Items. 


can be omitted from the end of the list, implying use of the 
default values. Also, a value of zero for t (c) results in 
two null bytes per tab (character). The former may be 
needed for C programs, the latter for files like 
letc/passwd . Because terminal behavior varies according 
to the specific characters printed and the load on a sys- 
tem, the user may have to experiment with these values 
to get correct output. The —d option exists only as a last 
resort for those few cases that do not otherwise print 
properly. For example, the file /etc/passwd may be 
printed using —d3,30,5 . The value —d0,1 is a good one to 
use for C programs that have many levels of indentation. 


Note that the delay control interacts heavily with the pre- 
vailing carriage return and line-feed delays. The stty (7) 
modes nlO cr2 or nlQ cr3 are recommended for most 
uses. 


The 300 command can be used with the nroff -s flag or .rd 
requests, when it is necessary to insert paper manually or change 
fonts in the middle of a document. Instead of hitting the return key 
in these cases, you must use the line-feed key to get any response. 


In many (but not all) cases, the following sequences are equivalent: 


nroff —T300 files... and _ nroff files ... | 300 
nroff -T300—12 files... and _ nroff files ... | 300 +12 


The use of 300 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move- 
ment optimization of 300 may produce better-aligned output. 


The neqn names of, and resulting output for, the Greek and special 
characters supported by 300 are shown in greek (7). 


SEE ALSO 


BUGS 


450(1), eqn(1), graph(1G), mesg(1), nroff(1), stty(1), tabs(1), tbl(1), 
tplot(1G), greek(1). 
Sys5 UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. 


Some special characters cannot be correctly printed in column 1 
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because the print head cannot be moved to the left from there. 
ao 3 lf your output contains Greek and/or reverse line-feeds, use a 
( friction-feed platen instead of a forms tractor; although good enough 
. for drafts, the latter has a tendency to slip when reversing direction, 
distorting Greek characters and misaligning the first line of text after 
one or more reverse line-feeds. 
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NAME 


4014 — paginator for the TEKTRONIX 4014 terminal 


SYNOPSIS 


4014 [-+t][—-n][-cN][-pL ] [ file ] 


DESCRIPTION 


The output of 4074 is intended for a TEKTRONIX 4014 terminal; 
4014 arranges for 66 lines to fit on the screen, divides the screen 
into N columns, and contributes an eight-space page offset in the 
(default) single-column case. Tabs, spaces, and backspaces are 
collected and plotted when necessary. TELETYPE® Model 37 half- 
and reverse-line sequences are interpreted and plotted. At the end 
of each page, 4014 waits for a new-line (empty line) from the key- 
board before continuing on to the next page. In this wait state, the 
command !cmd will send the cmd to the shell. 


The command line options are: 


—t Do not wait between pages (useful for directing output into a 
file). 

—n Start printing at the current cursor position and never erase 
the screen. 

-cN Divide the screen into N columns and wait after the last 
column. 


-—pL Set page length to L ; L accepts the scale factors i (inches) 
and | (lines); default is lines. 


SEE ALSO 
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pr(1), tc(1), troff(1). 
Sys UNIX Documenter’'s Workbench Software introGuetion and 
Reference Manual. 
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NAME 
450 — handle special functions of the DAS! 450 terminal 
SYNOPSIS 
450 
DESCRIPTION 


The 450 command supports special functions of, and optimizes the 
use Of, the DAS! 450 terminal, or any terminal that is functionally 
identical, such as the DIABLO 1620 or XEROX 1700. It converts 
half-line forward, half-line reverse, and full-line reverse motions to 
the correct vertical motions. It also attempts to draw Greek letters 
and other special symbols in the same manner as 300 (7). Use 450 
to print equations neatly, in the sequence: 


neqn file ... | nroff | 450 


WARNING: make sure that the PLOT switch on your terminal is ON 
before 450 is used. The SPACING switch should be put in the 
desired position (either 10- or 12-pitch). In either case, vertical 
spacing is 6 lines/inch, unless dynamically changed to 8 lines per 
inch by an appropriate escape sequence. 


Use 450 with the nroff —s flag or .rd requests when it is necessary 
to insert paper manually or change fonts in the middle of a docu- 
ment. Instead of hitting the return key in these cases, you must use 
the line-feed key to get any response. 


In many (but not all) cases, the use of 450 can be eliminated in 
favor of either nroff —T450 files... or nroff —T450-12 files... 


The use of 450 can thus often be avoided unless. special delays or 
options are required; in a few cases, however, the additional move- 
ment optimization of 450 may produce better-aligned output. 


The neqgn names of, and resulting output for, the Greek and special 
characters supported by 450 are shown in greek (7). 


SEE ALSO 


BUGS 
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300(1), eqn(1), graph(1G), mesg(1), nroff(1), stty(1), tabs(1), tbl(1), 
tplot(1G), greek(1). | 
Sys5 UNIX Documenter’s Workbench Software Introduction and 


Reference Manual. 


Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a 
friction-feed platen instead of a forms tractor; although good enough 
for drafts, the latter has a tendency to slip when reversing direction, 
distorting Greek characters and misaligning the first line of text after 
one or more reverse line-feeds. 
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NAME 


acctcom — search and print process accounting file(s) 


SYNOPSIS 


acctcom [[options][file]] ... 


DESCRIPTION 
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Acctcom reads file , the standard input, or /usr/adm/pacct , in the 
form described by acct (4) and writes selected records to the stan- 
dard output. Each record represents the execution of one process. 
The output shows the COMMAND NAME , USER , TTYNAME , START 
TIME , END TIME , REAL (SEC) , CPU (SEC) , MEAN SIZE(K) , and 
optionally, F (the fork / exec flag: 1 for fork without exec), STAT (the 
system exit status), HOG FACTOR, KCORE MIN, CPU FACTOR, 
CHARS TRNSFD, and BLOCKS READ (total blocks read and written). 


The command name is prepended with a # if it was executed with 
Super - user privileges. If a process is not associated with a known 
terminal, a ? is printed in the TTYNAME field. 


If no files are specified, and if the standard input is associated with 
a terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read; otherwise, the standard input is read. 


lf any fife arguments are given, they are read in their respective 
order. Each file is normally read forward, i.e., in chronological order 
by process completion time. The file /usr/adm/pacct is usually the 
current file to be examined; a busy system may need several such 
files of which all but the current file are found in /usr/adm/pacct? . 
The options are: 


—a Show some average statistics about the processes 
selected. The statistics will be printed after the output 
records. 

—b Read backwards, showing latest commands first. This 
option has no effect when the standard input is read. 

—f Print the fork / exec flag and system exit status 
columns in the output. 

-h Instead of mean memory size, show the fraction of 


total available CPU time consumed by the process dur- 
ing its execution. This “hog factor’ is computed as: 
(total CPU time)/(elapsed time). 
—i Print columns containing the I/O counts in the output. 


—k Instead of memory size, show total kcore-minutes. 

-—m Show mean core size (the default). 

—f _ Show CPU factor (user time/(system-time + user- 
time). 

—t Show separate system and user CPU times. 

-V Exclude column headings from the output. 
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—I line Show only processes belonging to terminal /dev/line. 
—u user Show only processes belonging to user that may be | 

specified by: a user ID, a login name that is then con- 
verted to a user ID, a # which designates only those 
processes executed with super - user privileges, or ? 
which designates only those processes associated 
with unknown user IDs. 

-g group _—_ Show only processes belonging to group . The group 
may be designated by either the group ID or group 
name. 

-s time Select processes existing at or after time , given in the 
format hr [: min [: sec ] ]. 

—e time Select processes existing at or before time . 

—-S time Select processes starting at or after time . 

—E time Select processes ending at or before time . Using the 
same time for both —S and —E shows the processes 
that existed at time. 

—n pattern Show only commands matching pattern that may be a 
regular expression as in ed (7) except that + means 
one or more occurrences. 

—q Do not print any output records, just print the average 
statistics as with the —a option. 

-0 Ofile Copy selected process records in the input data format 
to ofile ; supress standard output printing. 

-H factor Show only processes that exceed factor , where factor 
is the “hog factor” as explained in option -h above. 

—O sec Show only processes with CPU system time exceeding 
sec seconds. 3 

-C sec Show only processes with total CPU time, system plus 
user, exceeding sec seconds. 

-| chars Show only processes transferring more characters 
than the cut-off number given by chars . 

FILES Oo 
/etc/passwd 
/usr/adm/pacct 
/etc/group 

SEE ALSO 


ps(1), su(1). 


acct(2), acct(4), utmp(4) in the Sys5 UNIX Programmer Reference 


Manual. 


acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), 
acctsh(1M), fwtmp(1M), runacct(1M) in the "Sys5 UNIX Administra- 
tor Reference Manual" . 
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7 BUGS 
( Acctcom only reports on processes that have terminated; use ps 


(1) for active processes. If time exceeds the present time, then 
time is interpreted as occurring on the previous day. 
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NAME 


) UNIX Sys5 ADB (1) 


adb — absolute debugger 


SYNOPSIS 


adb [—w] [ objfil [ corfil ] ] 


DESCRIPTION 


Adb is a general purpose debugging program. It may be used to 
examine files and to provide a controlled environment for the execu- 
tion of UNIX system programs. 


Objfil is normally an executable program file, preferably containing a 
symbol table; if not then the symbolic features of adb cannot be used 
although the file can still be examined. The default for objfi! is a.out. 
Corfil is assumed to be a core image file produced after executing 
objfil ; the default for corfil is core . 


Requests to adb are read from the standard input and responses are 
to the standard output. If the —w flag is present then both objfil and 
corfil are created if necessary and opened for reading and writing so 
that files can be modified using adb . Adb ignores QUIT; INTERRUPT 
causes return to the next adb command. 


In general requests to adb are of the form 
[address] [, count ] [command] [;] 


Address and count are expressions. If address is present, dot. is set 
to address. Initially it is set to O. For most commands count 
specifies how many times the command will execute. The default 
count is 1. | 


The interpretation of an address depends on the context it is used in. 
lf a subprocess is being debugged then addresses are interpreted in 
the usual way in the address space of the subprocess. For further 
details of address mapping see ADDRESSES. 


EXPRESSIONS 
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‘ The value of dot. 
+ The value of dot incremented by the current increment. 


an 


The value of dot decremented by the current increment. 


The last address typed. 


integer 
An octal number if integer begins with a 0; a hexadecimal 
number if preceded by # ; otherwise a decimal number. 


integer .fraction 
A 32-bit floating point number. 


‘cccc’ The ASCII value of up to 4 characters. A \ may be used to 
escape a’. 


< name 
The value of name, which is either a variable name or a regis- 


ter name. Adb maintains a number of variables (see VAARI-. 


ABLES) named by single letters or digits. If name is a register 
name then the value of the register is obtained from the sys- 
tem header in corfil .. The register names are r0 ... r11 sp pe ps 
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fp ap for the VAX and r0Q ... r5 sp pc ps for the PDP-11. 


eRe. symbol 
( A symbol is a sequence of upper or lower case letters, under- 
ae scores or digits, not starting with a digit. The value of the 
symbol is taken from the symbol table in objffif . An initial _ or 
~ will be prefixed to symbo/ if needed. 


_ symbol 
In C, the ‘‘true name”’ of an external symbol begins with _. It 
may be necessary to utter this name to distinguish it from 
internal or hidden variables of a program. 


routine name 
The address of the variable name in the specified C routine. 
Both routine and name are symbols . lf name is omitted the 
value is the address of the most recently activated C stack 
frame Corresponding to routine . 


(exp) The value of the expression exp . 
Monadic operators: 
«exp The contents of the location addressed by exp in corfil 


@exp The contents of the location addressed by exp in objfil 


ate —exp Integer negation. 
( ~exp Bitwise complement. 


Dyadic operators are left associative and are less binding than 
monadic operators. 


e7? +e2 
Integer addition. 


e? —e2 

Integer subtraction. 
e7 se2 Integer multiplication. 
et %e2 

Integer division. 
e? &e2 Bitwise conjunction. 
e? je2 Bitwise disjunction. 


el #e2 
E71 rounded up to the next multiple of e2 . 


COMMANDS | 
| Most commands consist of a verb followed by a modifier or list of 
modifiers. The following verbs are available. (The commands ? and / 
may be followed by « ; see ADDRESSES for further details.) 


oy ?f Locations starting at address in objfil are printed according to 
oe the format f. dot is incremented by the sum of the increments 
- for each format letter (q.v.). 
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If Locations starting at address in corfil are printed according to 
the format f and dot is incremented as for ?. 


=f The value of address itself is printed in the styles indicated by 
the format f . (For i format ? is printed for the parts of the 
instruction that reference subsequent words.) 


A format consists of one or more characters that specify a style of 
printing. Each format character may be preceded by a decimal 
integer that is a repeat count for the format character. While step- 
ping through a format, dot is incremented by the amount given for 
each format letter. If no format is given then the last format is used. 
The format letters available are as follows: 


o 2 


QqQq0c TNn*®CoC KK OaAOL O 
aeiat COAANAN ANAND A 


= 


Print 2 bytes in octal. All octal numbers output by adb 
are preceded by 0. 

Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the following 
escape convention. Character values 000 to 040 are 
printed as @ followed by the corresponding character 
in the range 0100 to 0140. The character @ is printed 
as @@. 

Print the addressed characters until a zero character is 
reached. 

Print a string using the @ escape convention. The 
value n is the length of the string including its zero 
terminator. 

Print 4 bytes in date format (see ctime (3C)). 

Print as PDP-11 instructions. The value n is the 
number of bytes occupied by the instruction. This 
Style of printing causes variables 1 and 2 to be set to 
the offset parts of the source and destination, respec- 
tively. 

Print the value of dot in symbolic form. Symbols are 
checked to ensure that they have an appropriate type 
as indicated below. 


/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 


Print the addressed value in symbolic form using the 
same rules for symbol lookup as a. 
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t 0 When preceded by an integer, tabs to the next 
appropriate tab stop. For example, 8t moves to the 
next 8-space tab stop. 

Print a space. 
Print a new-line. 

Q Print the enclosed string. 

Dot is decremented by the current increment. Nothing 
is printed. 

+ Dot is incremented by 1. Nothing is printed. 

= Dot is decremented by 1. Nothing is printed. 


25 
"200 


new-line 
Repeat the previous command with a count of 1. 


[?/]l value mask 
Words starting at dot are masked with mask and compared 
with va/ue until a match is found. If L is used then the match 
is for 4 bytes at a time instead of 2. If no match is found then 
dot is unchanged; otherwise dot is set to the matched loca- 
tion. If mask is omitted then —1 is used. 


[?/]w value... - 
Write the 2-byte va/ue into the addressed location. If the 
command is W , write 4 bytes. Odd addresses are not 
allowed when writing to the subprocess address space. 


[?/)m b7 ef f1[?/] 

New values for (b?, e1, f1) are recorded. If less than three 
expressions are given then the remaining map parameters are 
left unchanged. If the ? or / is followed by « then the second 
segment (b2,e2,f2) of the mapping is changed. If the list is 
terminated by ? or / then the file (objfil or corfil , respectively) 
is used for subsequent requests. (So that, for example, /m? 
will cause / to refer to objfil .) 


>name 
Dot is assigned to the variable or register named. 
! A shell is called to read the rest of the line following ! . 
$modifier 
Miscellaneous commands. The available modifiers are: 
<f Read commands from the file f and return. 
>f Send output to the file f , which is created if it does 
not exist. 
r Print the general registers and the _ instruction 
addressed by pc. Dot is set to pe. 
f Print the floating registers in single or double length. If 


the floating point status of ps is set to double (0200 
bit) then double length is used anyway. 


b Print all breakpoints and their associated counts and 
commands. 
a ALGOL 68 stack backtrace. If address is given then it 


is taken to be the address of the current frame 
(instead of r4 ). If count is given then only the first 
count frames are printed. 
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:modifier 
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C stack backtrace. If address is given then it is taken 
as the address of the current frame (instead of rd ). If 
C is used then the names and (16-bit) values of all 
automatic and static variables are printed for each 
active function. If count is given then only the first 
count frames are printed. 

The names and values of external variables are 
printed. 

Set the page width for output to address (default 80). 
Set the limit for symbol matches to address (default 
255). 

All integers input are regarded as octal. 

Reset integer input as described in EXPRESSIONS. 

Exit from adb. 

Print all non-zero variables in octal. 

Print the address map. 


Manage a subprocess. Available modifiers are: 


be 


cs 


Ss 


Set breakpoint at address . The breakpoint is executed 
count —7 times before causing a stop. Each time the 
breakpoint is encountered the command c is exe- 
cuted. If this command sets dot to zero then the 
breakpoint Causes a stop. 


Delete breakpoint at address . 


Run objfil as a subprocess. If address is given expli- 
citly then the program is entered at this point; other- 
wise the program is entered at its standard entry point. 
The value count specifies how many breakpoints are 
to be ignored before stopping. Arguments to the sub- 
process may be supplied on the same line as the com- 
mand. An argument starting with < or > causes the 
standard input or output to be established for the 
command. All signals are turned on on entry to the 
subprocess. 


The subprocess is continued with signal s (see signal 
(2)). \f address is given then the subprocess is contin- 
ued at this address. lf no signal is specified then the 
signal that. caused the subprocess to stop is sent. 


Breakpoint skipping is the same as forr. 


As for c except that the subprocess is single stepped 
count times. If there is no current subprocess then 
objfil is run as a subprocess as for r. In this case no 
signal can be sent; the remainder of the line is treated 
as arguments to the subprocess. 


The current subprocess, if any, is terminated. 


Attach to another running process. The syntax is 
PID:p. 


Detach from process attached to with sp. 
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VARIABLES 


Adb provides a number of variables. Named variables are set initially 
by adb but are not used subsequently. Numbered variables are 
reserved for communication as follows. 


0 The last value printed. 
1 The last offset part of an instruction source. 
2 The previous value of variable 1. 


On entry the following are set from the system header in the corfil . If 
corfil does not appear to be a core file, then these values are set 
from objfil . 


The base address of the data segment. 

The data segment size. 

The entry point. 

The ‘“‘magic’’ number (0405, 0407, 0410 or 0411). 
The stack segment size. 

The text segment size. 


*“n30AT 


ADDRESSES 


FILES 


The address in a file associated with a written address is determined 
by a mapping associated with that file. Each mapping is represented 
by two triples (b7, e7, f1) and (b2, e2, f2) and the file address 
corresponding to a written address is calculated as follows: 


b1 < address < e7 => file address = address + f1-b1 
otherwise 


b2 < address < e2 => file address = address + f2-b2, 


otherwise, the requested address is not legal. In some cases (e.g., 
for programs with separated | and D space) the two segments for a 
file may overlap. If a ? or / is followed by an « then only the second 
triple is used. 


The initial setting of both mappings is suitable for normal a.out and 
core files. If either file is not of the kind expected then, for that file, 
bf is set to 0, e7 is set to the maximum file size and f7 is set to 0; in 
this way the whole file can be examined with no address translation. 


In order for adb to be used on large files all appropriate values are 
kept as signed 32-bit integers. 


/dev/mem 
/dev/swap 
a.out 

core 


SEE ALSO 


ptrace(2), a.out(4), core(4) in the Sys5 UNIX Programmer Reference 
Manual. 


DIAGNOSTICS 


‘‘Adb”’ when there is no current command or format. Comments 
about inaccessible files, syntax errors, abnormal termination of com- 
mands, etc. Exit status is 0, unless last command failed or returned 
nonzero status. 
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A breakpoint set at the entry point is not effective on initial entry to 
the program. 

When single stepping, system calls do not count as an executed 
instruction. 

Local variables whose names are the same as an external variable 
may foul up the accessing of the external. 


On the VAX, there is some confusion about 2-byte versus 4-byte 
quantities. 
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NAME 
admin — create and administer SCCS files 


SYNOPSIS 
admin [-n] [-i[name]] [-rrel] [-t[name]]  ([-—fflag[flag-vall]] 
[—dflag[flag-val]] [—alogin] [—elogin] [—m[mrlist]] [—y[comment]] [—h] 
[—z] files 


DESCRIPTION 

Admin is used to create new SCCS files and change parameters of 
existing ones. Arguments to admin, which may appear in any order, 
consist of keyletter arguments, which begin with —, and named files 
(note that SCCS file names must begin with the characters s.). If a 
named file does not exist, it is created, and its parameters are initial- 
ized according to the specified keyletter arguments. Parameters not 
initialized by a keyletter argument are assigned a default value. If a 
named file does exist, parameters corresponding to specified 
keyletter arguments are changed, and other parameters are left as 
is. 


If a directory is named, admin behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files 
(last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of — is given, the 
standard input is read; each line of the standard input is taken to be 
the name of an SCCS file to be processed. Again, non-SCCsS files 
and unreadable files are silently ignored. 


The keyletter arguments are as follows. Each is explained as 
though only one named file is to be processed since the effects of 
the arguments apply independently to each named file. 


-—n This keyletter indicates that a new SCCS file 
is to be created. 


~i[name] The name of a file from which the text for a 
new SCCS file is to be taken. The text consti- 
tutes the first delta of the file (see —r keyletter 
for delta numbering scheme). If the i 
keyletter is used, but the file name is omitted, 
the text is obtained by reading the standard 
input until an end-of-file is encountered. If 
this keyletter is omitted, then the SCCS file is 
created empty. Only one SCCS file may be 
created by an admin command on which the 
i keyletter is supplied. Using a single admin 
to create two or more SCCS files requires that 
they be created empty (no -i keyletter). Note 
that the -i keyletter implies the —n keyletter. 
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The release into which the initial delta is 


inserted. This keyletter may be used only if 
the -i keyletter is also used. If the -r 
keyletter is not used, the initial delta is 
inserted into release 1. The level of the initial 
delta is always 1 (by default initial deltas are 
named 1.1). 


The name of a file from which descriptive text 
for the SCCS file is to be taken. If the -—t 
keyletter is used and admin is creating a new 
SCCS file (the -—n and/or -i keyletters also 
used), the descriptive text file name must 
also be supplied. In the case of existing 
SCCS files: (1) a -t keyletter without a file 
name causes removal of descriptive text (if 
any) currently in the SCCS file, and (2) a -t 
keyletter with a file name causes text (if any) 
in the named file to replace the descriptive 
text (if any) currently in the SCCS file. 


This keyletter specifies a flag, and, possibly, 
a value for the flag, to be placed in the SCCS 
file. Several f keyletters may be supplied on 
a single admin command line. The allowable 
flags and their values are: 


Allows use of the —b keyletter on a get (17) 
command to create branch deltas. 


The highest release (i.e., “ceiling’), a number 
less than or equal to 9999, which may be 
retrieved by a get (1) command for editing. 
The default value for an unspecified c flag is 
9999. 


The lowest release (i.e., “floor’), a number 
greater than O but less than 9999, which may 
be retrieved by a get (1) command for edit- 
ing. The default value for an unspecified f 
flag is 1. 


The default delta number (SID) to be used by 
a get (1) command. 


Causes the "No id keywords (ge6)" message 
issued by get (1) or delta (1) to be treated as 
a fatal error. In the absence of this flag, the 


message is only a warning. The message is © 


issued if no SCCS identification keywords 
(see get (1)) are found in the text retrieved or 
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list 


qtext 


mmod 


ttype 


v[pgm] 
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stored in the SCCS file. If a value is supplied, 
the keywords must exactly match the given 
string, however the string must contain a key- 
word, and no embedded newlines. 


Allows concurrent get (7) commands for edit- 
ing on the same SID of an SCCS file. This 
allows multiple concurrent updates to the 
same version of the SCCS file. 


A list of releases to which deltas can no 
longer be made (get —e against one of these 
“locked” releases fails). The fist has the fol- 
lowing syntax: 


<list> ::= <range> | <list> , <range> 
<range> ::= RELEASE NUMBER | a 


The character a in the /ist is equivalent to 
specifying all releases for the named SCCS 
file. 


Causes delta (1) to create a “null” delta in 
each of those releases (if any) being skipped 
when a delta is made in a new release (e.g., 
in making delta 5.1 after delta 2.7, releases 3 
and 4 are skipped). These null deltas serve 
as “anchor points” so that branch deltas may 
later be created from them. The absence of 
this flag causes skipped releases to be non- 
existent in the SCCS file, preventing branch 
deltas from being created from them in the 
future. 


User definable text substituted for all 
occurrences of the %Q% keyword in SCCS 
file text retrieved by get (7). 


Mod ule name of the SCCS file substituted for 
all occurrences of the %M% keyword in SCCS 
file text retrieved by get (7). If the m flag is 
not specified, the value assigned is the name 
of the SCCS file with the leading s. removed. 


Type of module in the SCCS file substituted 
for all occurrences of %Y% keyword in SCCS 
file text retrieved by get (7). 


Causes delta (1) to prompt for Modification 
Request (MR) numbers as the reason for 
creating a delta. The optional value specifies 
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the name of an MR number validity checking 
program (see delta (17)). (If this flag is set 
when creating an SCCS file, the m keyletter 
must also be used even if its value is null). 


Causes removal (deletion) of the specified 
flag from an SCCS file. The -—d keyletter may 
be specified only when processing existing 
SCCS files. Several —d keyletters may be 
supplied on a single admin command. See 
the —f keyletter for allowable flag names. 


A list of releases to be “unlocked”. See the 
—f keyletter for a description of the | flag and 
the syntax of a /ist. 


A login name, or numerical UNIX system 
group ID, to be added to the list of users 
which may make deltas (changes) to the 
SCCS file. A group ID is equivalent to specify- 
ing all login names common to that group ID. 
Several a keyletters may be used on a single 
admin command line. As many logins, or 
numerical group IDs, as desired may be on 
the list simultaneously. If the list of users is 
empty, then anyone may add deltas. If login 
or group ID is preceded by a ! they are to be 
denied permission to make deltas. 


A login name, or numerical group ID, to be 
erased from the list of users allowed to make 
deltas (changes) to the SCCS file. Specifying 
a group ID is equivalent to specifying all login 
names common to that group ID. Several e 
keyletters may be used on a single admin 
command line. 


The comment text is inserted into the SCCS 
file as a comment for the initial delta in a 
manner identical to that of delta (1). Omis- 
sion of the -y keyletter results in a default 
comment line being inserted in the form: 


date and time created YY / MM / DD HH : MM 
: SS by login 


The —y keyletter is valid only if the —i and/or 
—n keyletters are specified (i.e., a new SCCS 
file is being created). 
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—m([mriist] The list of Modification Requests (MA) 
numbers is inserted into the SCCS file as the 
reason for creating the initial delta in a 
manner identical to delta (1). The v flag must 
be set and the MR numbers are validated if 
the v flag has a value (the name of an MR 
number validation program). Diagnostics will 
occur if the v flag is not set or MR validation 
fails. 


—h Causes admin to check the structure of the 
SCCS file (See sccsfile(5)), and to compare a 
newly computed check-sum (the sum of all 
the characters in the SCCS file except those 
in the first line) with the check-sum that is 
stored in the first line of the SCCS file. 
Appropriate error diagnostics are produced. 


This keyletter inhibits writing on the file, so 
that it nullifies the effect of any other 
keyletters supplied, and is, therefore, only 
meaningful when processing existing files. 


—Z The SCCS file check-sum is recomputed and 
stored in the first line of the SCCS file (see —h 
, above). 


Note that use of this keyletter on a truly cor- 
rupted file may prevent future detection of the 
corruption. 


The last component of all SCCS file names must be of the form 
s.file-name. New SCCS files are given mode 444 (see chmod (71)). 
Write permission in the pertinent directory is, of course, required to 
create a file. All writing done by admin is to a temporary x-file, 
called x.file-name, (see get (1)), created with mode 444 if the 
admin command is creating a new SCCS file, or with the same 
mode as the SCCS file if it exists. After successful execution of 
admin, the SCCS file is removed (if it exists), and the x-file is 


renamed with the name of the SCCS file. This ensures that changes 


are made to the SCCS file only if no errors occurred. 


It is recommended that directories containing SCCS files be mode 
755 and that SCCS files themselves be mode 444. The mode of the 
directories allows only the owner to modify SCCS files contained in 
the directories. The mode of the SCCS files prevents any modifica- 
tion at all except by SCCS commands. 


If it should be necessary to patch an SCCS file for any reason, the 
mode may be changed to 644 by the owner allowing use of ed (7). 
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Care must be taken! The edited file should always be processed by 
an admin —h to check for corruption followed by an admin -z to | 
generate a proper check-sum. Another admin —h is recommended “ | 
to ensure the SCCS file is valid. 


Admin also makes use of a transient lock file (called z.file-name), 
which is used to prevent simultaneous updates to the SCCS file by 
different users. See get (7) for further information. 


SEE ALSO 
delta(1), ed(1), get(1), help(1), prs(1), what(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
Use help (1) for explanations. 
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ar — archive and library maintainer for portable archives 


SYNOPSIS 


ar key [ posname ] afile [name] ... 


DESCRIPTION 
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The Ar command maintains groups of files combined into a single 
archive file. Its main use is to create and update library files as 
used by the link editor. It can be used, though, for any similar pur- 
pose. The magic string and the file headers used by ar consist of 
printable ASCII characters. If an archive is composed of printable 
files, the entire archive is printable. 


When ar creates an archive, it creates headers in a format that is 
portable across all machines. The portable archive format and 
structure is described in detail in ar (4). The archive symbol table 
(described in ar (4)) is used by the link editor (/d(1)) to effect multi- 
ple passes over libraries of object files in an efficient manner. An 
archive symbol table is only created and maintained by ar when 
there is at least one object file in the archive. The archive symbol 
table is in a specially named file which is always the first file in the 
archive. This file is never mentioned or accessible to the user. 
Whenever the ar (1) command is used to create or update the con- 
tents of such an archive, the symbol table is rebuilt. The s option 
described below will force the symbol table to be rebuilt. 


Key is an optional — , followed by one character from the set 
drqtpmx , optionally concatenated with one or more of vuaibcls . 
Afile is the archive file. The names are constituent files in the 
archive file. The meanings of the key characters are: 


d Delete the named files from the archive file. 


r Replace the named files in the archive file. If the optional 
character u is used with r , then only those files with dates 
of modification later than the archive files are replaced. If 
an optional positioning character from the set abi is used, 
then the posname argument must be present and specifies 
that new files are to be placed after (a) or before (b or i ) 
posname . Otherwise new files are placed at the end. 


q Quickly append the named files to the end of the archive 
file. Optional positioning characters are invalid. The com- 
mand does not check whether the added members are 
already in the archive. Useful only to avoid quadratic 
behavior when creating a large archive piece-by-piece. 


t Print a table of contents of the archive file. If no names are 
given, all files in the archive are tabled. If names are given, 
only those files are tabled. 
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SEE ALSO 
arcv(1), lorder(1), strip(1). 
tmpnam(3$8), a.out(4), ar(4) in the Sys5 UNIX Programmer Refer- 
ence Manual. 


NOTES 
This archive format is not the same as that of Syss3. 


BUGS 
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Print the named files in the archive. 


Move the named files to the end of the archive. If a posi- 
tioning character is present, then the posname argument 
must be present and, as in r , specifies where the files are 
to be moved. 


Extract the named files. If no names are given, all files in 
the archive are extracted. In neither case does x alter the 
archive file. 


Give a verbose file-by-file description of the making of a 
new archive file from the old archive and the constituent 
files. When used with t , give a long listing of all information 
about the files. When used with x , precede each file with a 
name. 


Suppress the message that is produced by default when 
afile is created. 


Place temporary files in the local current working directory, 
rather than in the directory specified by the environment 
variable TMPDIR or in the default directory /tmp . 


Force the regeneration of the archive symbol table even if 
ar (1) is not invoked with a command which will modify the 
archive contents. This command is useful to restore the 
archive symbol table after the strip (1) command Nee been 
used on the archive. 


temporaries 


If the same file is mentioned twice in an argument list, it may be put 
in the archive twice. 
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NAME 
arcv — convert archive files from PDP-11 to common archive format 


SYNOPSIS 
arcv infile outfile 


DESCRIPTION 
Arcv converts source archive files from the Sys5 UNIX portable 
archive format. The input archive file infile is converted to an 
equivalent output archive file ouffile . Note that there is no conver- 
sion of the members of the input archive file. 


FILES 
/tmp/arcv* 


SEE ALSO 
ar(1). 
ar(4) in the Sys5 UNIX Programmer Reference Manual. 
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as — common assembler 


SYNOPSIS 
as [-o objfile] [-n] [-j] [-m] [-R] [-r] [-{bwl]] [-V] file-name 


The as command assembles the named file. The following flags 
may be specified in any order: 


—O objfile Put the output of the assembly in objfile . By default, the 


—-n 


output file name is formed by removing the -.s suffix, if 
there is one, from the input file name and appending a .o 
suffix. 


Turn off long’short address optimization. By default, 
address optimization takes place. 


Invoke the long-jump assembler. The address optimiza- 
tion algorithm chooses between long and short address 
lengths, with short lengths chosen when possible. Often, 
three distinct lengths are allowed by the machine archi- 
tecture; a choice must be made between two of those 
lengths. When the two choices given to the assembler 
exclude the largest length allowed, then some addresses 
might be unrepresentable. The long-jump assembler will 
always have the largest length as one of its allowable 
choices. lf the assembler is invoked without this option, 
and the case arises where an address is unrepresentable 
by either of the two allowed choices, then the user will be 
informed of the error, and advised to try again using the 
—j option. 

Run the m4 macro pre-processor on the input to the 
assembler. 


Remove (unlink) the input file after assembly is com- 
pleted. 


Place all assembled data (normally placed in the .data 
section) into the .text section. This option effectively dis- 
ables the .data pseudo operation. This option is off by 
default. 
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—[bwl] Create byte (b), halfword (w) or long (1) displacements for 


undefined symbols. (An undefined symbol is a reference 
to a symbol whose definition is external to the input file or 
a forward reference.) The default value for this option is 
long (I) displacements. 


-V Write the version number of the assembler being run on 
the standard error output. 


/usritmp, as[1-6]XXXXXX temporary files 


SEE ALSO 


Id(1), m4(1), nm(1), strip(1). 
a.out(4) in the Sys5 UNIX Programmer Reference Manual. 


WARNING 


BUGS 
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If the -m (m4 macro pre-processor invocation) option is used, key- 
words for m4 (see m4(1)) cannot be used as symbols (variables, 
functions, labels) in the input file since m4 cannot determine which 
are assembler symbols and which are real m4 macros. 


Use the —b or —w option only when undefined symbols are known to 
refer to locations representable by the specified default displace- 
ment. Use of either option when assembling a file containing a 
reference to a symbol that is to be resolved by the loader can lead 
to unpredictable results, since the loader may be unable to place the 
address of the symbol into the space provided. 


The .align assembler directive is not guaranteed to work in the .text 
section when optimization is performed. 


Arithmetic expressions may only have one forward referenced sym- 
bol per expression. 
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asa — interpret ASA carriage control characters 
SYNOPSIS 
asa [files] 
DESCRIPTION 


Asa interprets the output of FORTRAN programs that utilize ASA car- 
riage control characters. It processes either the files whose names 
are given as arguments or the standard input if no file names are 
supplied. The first character of each line is assumed to be a control 
character; their meanings are: 


. 2 (blank) single new line before printing 
0 double new line before printing 

1 new page before printing 

+ overprint previous line. 


Lines beginning with other than the above characters are treated as 
if they began with ’ ’ . The first character of a line is not printed. If 
any such lines appear, an appropriate diagnostic will appear on 
Standard error. This program forces the first line of each input file to 
start on a new page. 


To view correctly the output of FORTRAN programs which use ASA 
Carriage control characters, asa could be used as a filter thus: 


a.out | asa | Ip 
and the output, properly formatted and paginated, would be directed 
to the line printer. FORTRAN output sent to a file could be viewed 


by: 


asa file 


SEE ALSO 
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at, batch — execute commands at a later time 


SYNOPSIS 


at time [ date | [ + increment | 
at -r job ... 
at -/ [ job... ] 


batch 


DESCRIPTION 
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At and batch read commands from standard input to be executed at 
a later time. At allows you to specify when the commands should 
be executed, while jobs queued with batch will execute when sys- 
tem load level permits. At -r removes jobs previously scheduled 
with at. The -! option reports all jobs scheduled for the invoking 
user. 


Standard output and standard error output are mailed to the user 
unless they are redirected elsewhere. The shell environment vari- 
ables, current directory, umask, and ulimit are retained when the 
commands are executed. Open file descriptors, traps, and priority 
are lost. 


Users are permitted to use at if their name appears in the file 
/usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if the user should be 
denied access to at. If neither file exists, only root is allowed to sub- 
mit a job. If either file is at.deny, global usage is permitted. The 
allow/deny files consist of one user name per line. 


The time may be specified as 1, 2, or 4 digits. One and two digit 
numbers are taken to be hours, four digits to be hours and minutes. 
The time may alternately be specified as two numbers separated by 
a colon, meaning hour : minute . A suffix am or pm may be 
appended; otherwise a 24-hour clock time is understood. The suffix 
zulu may be used to indicate GMT. The special names noon , mid- 
night , now , and next are also recognized. 


An optional date may be specified as either a month name followed 
by a day number (and possibly year number preceded by an 
optional comma) or a day of the week (fully spelled or abbreviated 
to three characters). Two special “days”, today and tomorrow are 
recognized. If no date is given, today is assumed if the given hour 
is greater than the current hour and tomorrow is assumed if it is 
less. If the given month is less than the current month (and no year 
is given), next year is assumed. 


The optional increment is simply a number suffixed by one of the 
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following: minutes , hours , days , weeks , months , or years . 
(The singular form is also accepted.) 


_ Thus legitimate commands include: 


at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday 


At and batch write the job number and schedule time to standard 
error. 


Batch submits a batch job. It is almost equivalent to “at now’, but 
not quite. For one, it goes into a different queue. For another, 
“at now” will respond with the error message too late. 


At -r removes jobs previously scheduled by at or batch . The job 
number is the number given to you previously by the af or batch 
command. You can also get job numbers by typing af -l. You can 
only remove your own jobs unless you are the super-user. 


EXAMPLES 


FILES 


The at and batch commands read from standard input the com- 
mands to be executed at a later time. Sh (7) provides different 
ways of specifying standard input. Within your commands, it may 
be useful to redirect standard output. 


This sequence can be used at a terminal: 
batch 
nroff filename >outtile 
<control-D> (hold down ‘control’ and depress 'D’) 


This sequence, which demonstrates redirecting standard error to a 
pipe, is useful in a shell procedure (the sequence of output redirec- 
tion specifications is significant): 

batch <<! 


nroff filename 2>&1 >outfile | mail loginid 


To have a job reschedule itself, invoke at from within the shell pro- 
cedure, by including code similar to the following within the shell file: 
echo "sh shelifile" | at 1900 thursday next week 


/usr/lib/cron - main cron directory 
/usr/lib/cron/at.allow - list of allowed users 
/usrilib/cron/at.deny - list of denied users 
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/usr/lib/cron/queue : scheduling information fas 
/ust/spool/cron/atjobs - spool area a 
SEE ALSO 


kill(1), mail(1), nice(1), ps(1), sh(1). 
cron(1M) in the Sys5 UNIX Administrator Reference Manual. 


DIAGNOSTICS 
Complains about various syntax errors and times out of range. 
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awk — pattern scanning and processing language 


SYNOPSIS 


awk [ -F c ] [ prog ] [ parameters ] [ files ] 


DESCRIPTION 


Awk scans each input file for lines that match any of a set of pat- 
terns specified in prog . With each pattern in prog there can be an 
associated action that will be performed when a line of a file 
matches the pattern. The set of patterns may appear literally as 
prog , or in a file specified as -f file . The prog string should be 
enclosed in single quotes (’) to protect it from the shell. 


Parameters, in the form x=... y=... etc., may be passed to awk. 


Files are read in order; if there are no files, the standard input is 
read. The file name — means the standard input. Each line is 
matched against the pattern portion of every pattern-action state- 
ment; the associated action is performed for each matched pattern. 


An input line is made up of fields separated by white space. (This 
default can be changed by using FS; see below). The fields are 
denoted $1 , $2, ...; $0 refers to the entire line. 


A pattern-action statement has the form: 
pattern { action } 


A missing action means print the line; a missing pattern always 
matches. An action is a sequence of statements. A statement can 
be one of the following: 


if ( conditional ) statement [ else statement | 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, new-lines, or right 
braces. An empty expression-list stands for the whole line. Expres- 
sions take on string or numeric values as appropriate, and are built 
using the operators + ,-, * ,/, %, and concatenation (indicated 
by a blank). The C operators ++ ,—,+=,-=,*=,/=, and 
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%= are also available in expressions. Variables may be scalars, 
array elements (denoted x[i]) or fields. Variables are initialized to 
the null string. Array subscripts may be any string, not necessarily 
numeric; this allows for a form of associative memory. String con- 
stants are quoted ("). 


The print statement prints its arguments on the standard output (or 
on a file if >expr is present), separated by the current output field 
separator, and terminated by the output record separator. The 
printf statement formats its expression list according to the format 
(see printf (3S)). 


The built-in function length returns the length of its argument taken 
as a string, or of the whole line if no argument. There are also 
built-in functions exp , log , sqrt , and int . The last truncates its 
argument to an integer; substr(s, m,n) returns the n -character 
substring of s that begins at position m . The function sprintf ( fmt , 
expr, expr, ... ) formats the expressions according to the printf 
(3S) format given by fmt and returns the resulting string. 


Patterns are arbitrary Boolean combinations (!, ||, && , and 
parentheses) of regular expressions and relational expressions. 
Regular expressions must be surrounded by slashes and are as in 
egrep (see grep (1)). \solated regular expressions in a pattern 
apply to the entire line. Regular expressions may also occur in rela- 
tional expressions. A pattern may consist of two patterns separated 
by a comma; in this case, the action is performed for all lines 
between an occurrence of the first pattern and the next occurrence 
of the second. 


A relational expression is one of the following: 


expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a 
matchop is either ~ (for contains ) or !" (for does not contain ). A 
conditional is an arithmetic expression, a relational expression, or a 
Boolean combination of these. 


The special patterns BEGIN and END may be used to capture control 
before the first input line is read and after the last. BEGIN must be 
the first pattern, END the last. 


A single character c may be used to separate the fields by starting 
the program with: 


BEGIN{ FS =c} 
or by using the -Fc option. 
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: Other variable names with special meanings include NF, the number 

( “ of fields in the current record; NR, the ordinal number of the current 

record; FILENAME, the name of the current input file; OFS, the output 

field separator (default blank); ORS, the output record separator 

(default new-line); and OFMT, the output format for numbers (default 
%.6g ). 


EXAMPLES 
Print lines longer than 72 characters: 


length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Add up first column, print sum and average: 
{Ss += $1} 
END { print "sum is", s, " average is", s/NR } 
Print fields in reverse order: 
{ for (i = NF; i > 0; —i) print $i } 
Print all lines between start/stop pairs: 
‘start’, ‘stop/ 
( | Print all lines whose first field is different from previous one: 
$1 '= prev { print; prev = $1 } 
Print file, filling in page numbers starting at 5: 
;Pagei { $2 = n++; } 
{ print } 
command line: awk —f program n=5 input 
SEE ALSO 


grep(1), lex(1), sed(1). 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


Sys5 UNIX Support Tools Guide. 


BUGS 
Input white space is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number add 0 to it; to force it 
to be treated as a string concatenate the null string ("") to it. 


C 
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NAME 
banner — make posters 


SYNOPSIS 
banner strings 


DESCRIPTION 
Banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. 

SEE ALSO 
echo(1). 
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—_ NAME 
( basename, dirname — deliver portions of path names 


SYNOPSIS 
basename string [ suffix ] 
dirname string 


DESCRIPTION 
Basename deletes any prefix ending in / and the suffix (if present in 
string ) from string , and prints the result on the standard output. It 
is normally used inside substitution marks ( "s +" ) within shell pro- 
cedures. 


Dirname delivers all but the last level of the path name in string . 


EXAMPLES 
The following example, invoked with the argument 
/usr/src/cmd/cat.c , compiles the named file and moves the output 
to a file named cat in the current directory: 


cc $1 
mv a.out sbasename $1 *\.c’* 


The following example will set the shell variable NAME to 


oo -/usr/src/cmd : 
( NAME =* dirname /usr/src/cmd/cat.c> 
' SEE ALSO 
sh(1). 


BUGS 
The basename of / is null and is considered an error: 
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NAME | 
bar — Berkeley archive and library maintainer 


SYNOPSIS 
bar key [ posname ] afile name ... 


DESCRIPTION 
Bar maintains groups of files combined into a single archive file. Its 
main use is to create and update library files as used by the loader. 
It can be used, though, for any similar purpose. N.B: This version 
of bar uses a ASCll-format archive which is portable among the 
various machines running UNIX. Programs for dealing with older for- 
mats are available: see arcv(8). 


Key is one character from the set drqtpmx, optionally concatenated 
with one or more of uvnbail. Afile is the archive file. The names are 
constituent files in the archive file. The meanings of the key charac- 


ters are: 
d Delete the named files from the archive file. 
r Replace the named files in the archive file. If the optional 


character u is used with r, then only those files with ‘last- 
modified’ dates later than the archive files are replaced. If 
an optional positioning character from the set abi is used, 
then the posname argument must be present and specifies 
that new files are to be placed after (a) or before (b or i) 
posname. Otherwise new files are placed at the end. 


q Quickly append the named files to the end of the archive 
file. Optional positioning characters are invalid. The com- 
mand does not check whether the added members are 
already in the archive. Useful only to avoid quadratic 
behavior when creating a large archive piece-by-piece. 


t Print a table of contents of the archive file. If no names are 
given, all files in the archive are tabled. If names are given, 
only those files are tabled. 


p Print the named files in the archive. 


m Move the named files to the end of the archive. If a posi- 
tioning character is present, then the posname argument 
must be present and, as in r, specifies where the files are to 
be moved. 


x Extract the named files. If no names are given, all files in 
the archive are extracted. In neither case does x alter the 
archive file. Normally the ‘last-modified’ date of each 


extracted file is the date when it is extracted. However, if 0 


is used, the ‘last-modified’ date is reset to the date recorded 
in the archive. 
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Verbose. Under the verbose option, bar gives a file-by-file 
description of the making of a new archive file from the old 
archive and the constituent files. When used with t, it gives 
a long listing of all information about the files. When used 
with p, it precedes each file with a name. 


Create. Normally bar will create afile when it needs to. The 
create option suppresses the normal message that is pro- 
duced when afile is created. 


Local. Normally bar places its temporary files in the direc- 
tory /tmp. This option causes them to be placed in the local 
directory. 


/tmp/v* temporaries 


SEE ALSO 
lorder(1), arcv(1) 


If the same file is mentioned twice in an argument list, it may be put 
in the archive twice. 


The ‘last-modified’ date of a file will not be altered by the o option if 
the user is not the owner of the extracted file, or the super-user. 
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NAME 


bbanner — print large banner on printer 


SYNOPSIS 


/ust/plx/bbanner [ -wn ] message ... 


DESCRIPTION 


Bbanner prints a large, high quality banner on the standard output. 
If the message is omitted, it prompts for and reads one line of its 


Standard input. If -w is given, the output is scrunched down from a 


NOTES 


width of 132 to n , suitable for a narrow terminal. If n is omitted, it 
defaults to 80. 


The output should be printed on a hard-copy device, up to 132 
columns wide, with no breaks between the pages. The volume is 
enough that you want a printer or a fast hardcopy terminal, but if 
you are patient, a DECwriter or other 300 baud terminal will do. 


The Plexus version of this command is based on the one developed 
at the University of California at Berkeley. 


SEE ALSO 


BUGS 
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Several ASCII characters are not defined, notably <, >, [, ],\, 7°, _, 
{,}, and ~. Also, the characters ", ', and & are funny looking (but in 
a useful way.) 


The -w option is implemented by skipping some rows and columns. 
The smaller it gets, the grainier the output. Sometimes it runs 
letters together. 
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bc — arbitrary-precision arithmetic language 


SYNOPSIS 


be [ -c ] [ -I] [file ... ] 


DESCRIPTION 
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Bc is an interactive processor for a language that resembles C but 
provides unlimited precision arithmetic. It takes input from any files 
given, then reads the standard input. The -! argument stands for 
the name of an arbitrary precision math library. The syntax for bc 
programs is as follows; L means letter a—z, E means expression, S 


means statement. 


Comments 
are enclosed in /* and #/ . 


Names 
simple variables: L 
array elements: L[ E | 
The words “ibase’’, “obase’”’, and “scale” 


Other operands 


arbitrarily long numbers with optional sign and decimal point. 


(E) 

sqrt (E ) 

length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
LCE wage) 


Operators 
+ —+*/%~ (% iS remainder; * is power) 
++ — (prefix and postfix; apply to names) 
se <= >2+1-< > 


Statements 
E 
(S245) 
f(E)S 
while (E)S 
for(E;E;E)S 
null statement 
break 
quit 
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Function definitions 


define L(L,...,L){ | a—_ 
auto L,...,L ~ / 
So's 
return (E ) 
} 
Functions in —! math library 
S(x) sine 


c(x) cosine 

e(x) exponential 

I(x) log 

a(x) arctangent 
j(n,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or new-lines 
may separate statements. Assignment to scale influences the 
number of digits to be retained on arithmetic operations in the 
manner of dc (7). Assignments to /base or obase set the input and 
output number radix respectively. 


The same letter may be used as an array, a function, and a simple fo 
variable simultaneously. All variables are global to the program. . Ss 
“Auto” variables are pushed down during function calls. When ald 
using arrays as function arguments or defining them as automatic 
variables empty square brackets must follow the array name. 
Bc is actually a preprocessor for dc (7), which it invokes automati- 
cally, unless the —c (compile only) option is present. In this case 
the dc input is sent to the standard output instead. 
EXAMPLE 
scale = 20 
define e(x){ 
auto b, c, |, s 
Dp = 
Ss = 
for(i=1; 1==1;i1++)}{ 
b = bi 
c= s/b 
if(c == O) return(s) 
Ss =st+c 
} 
a 


defines a function to compute an approximate value of the \ 
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a exponential function and 
( for(i=1; ix<=10; i+ +) e(i) 

prints approximate values of the exponential function of the first ten 
integers. 

FILES 
/usr/lib/lib.b mathematical library 
/usr’bin/dc desk calculator proper 

SEE ALSO 
dc(1). 
Sys5 UNIX Programmer Guide. 

BUGS 


No &&, | | yet. 
For statement must have all three E's. 
Quit is interpreted when read, not when executed. 
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NAME 
bdiff — big diff 

SYNOPSIS 
bdiff file1 file2 [n] [-s] 

DESCRIPTION 
Bdiff is used in a manner analogous to diff (1) to find which lines 
must be changed in two files to bring them into agreement. Its pur- 
pose is to allow processing of files which are too large for diff . Baiff 
ignores lines common to the beginning of both files, splits the 
remainder of each file into n -line segments, and invokes diff upon 
corresponding segments. The value of n is 3500 by default. If the 
optional third argument is given, and it is numeric, it is used as the 
value for n . This is useful in those cases in which 3500-line seg- 
ments are too large for diff , causing it to fail. If file? (file2) is -, the 
standard input is read. The optional —s (silent) argument specifies | 
that no diagnostics are to be printed by bdiff (note, however, that 
this does not suppress possible exclamations by diff . If both 
optional arguments are specified, they must appear in the order indi- 
cated above. 
The output of bdiff is exactly that of diff, with line numbers adjusted 
to account for the segmenting of the files (that is, to make it look as 
if the files had been processed whole). Note that because of the 
segmenting of the files, bdiff does not necessarily find a smallest 
sufficient set of file differences. 

FILES 
/tmp/bd????? 

SEE ALSO 
diff(1). 

DIAGNOSTICS 
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Use help (1) for explanations. 
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NAME 

bfs — big file scanner 
SYNOPSIS 

bfs [ -— ] name 
DESCRIPTION 


The Bfs command is (almost) like ed (1) except that it is read-only 
and processes much larger files. Files can be up to 1024K bytes 
(the maximum possible size) and 32K lines, with up to 512 charac- 
ters, including new-line, per line (255 for 16-bit machines). Bfs is 
usually more efficient than ed for scanning a file, since the file is not 
copied to a buffer. It is most useful for identifying sections of a 
large file where csplit (1) can be used to divide it into more 
manageable pieces for editing. 


Normally, the size of the file being scanned is printed, as is the size 
of any file written with the w command. The optional — suppresses 
printing of sizes. Input is prompted with + if P and a carriage return 
are typed as in ed . Prompting can be turned off again by inputting 
another P and carriage return. Note that messages are given in 
response to errors if prompting is turned on. 


tion, regular expressions may be surrounded with two symbols 
besides / and ? : > indicates downward search without wrap- 
around, and < indicates upward search without wrap-around. 
There is a slight difference in mark names: only the letters a through 
Z may be used, and all 26 marks are remembered. 


( | All address expressions described under ed are supported. In addi- 


Thee,g,v,k,p,q,w, =, ! and null commands operate as 
described under ed . Commands such as ——, +++-, +++=, 
-12, and +4p are accepted. Note that 1,10p and 1,10 will both 
print the first ten lines. The f command only prints the name of the 
file being scanned; there-is no remembered file name. The w com- 
mand is independent of output diversion, truncation, or crunching 
(see the xo , xt and xc commands, below). The following addi- 
tional commands are available: 


xf file 
Further commands are taken from the named file . When 
an end-of-file is reached, an interrupt signal is received 
Or an error occurs, reading resumes with the file contain- 
ing the xf. The xf commands may be nested to a depth 
of 10. 


( xn___ List the marks currently in use (marks are set by the k 
{ command). 
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xo [ file ] | 3 


Further output from the p and null commands is diverted 
to the named file , which, if necessary, is created mode 
666. If file is missing, output is diverted to the standard 
output. Note that each diversion causes truncation or 
creation of the file. 


: label 


This positions a labe/ in a command file. The /abel is 
terminated by new-line, and blanks between the : and 
the start of the /abe/ are ignored. This command may 
also be used to insert comments into a command file, 
since labels need not be referenced. 


. )xb/regular expression'label 


A jump (either upward or downward) is made to /abel if 
the command succeeds. It fails under any of the follow- 
ing conditions: 
1. Either address is not between 1 and $. 
2. The second address is less than the first. 
3. The regular expression does not match at 
least one line in the specified range, including 
the first and last lines. 


On success, . is set to the line matched and a jump is 
made to /abe/. This command is the only one that does 
not issue an error message on bad addresses, so it may 
be used to test whether addresses are bad before other 
commands are executed. Note that the command 


xb/"/ label 


is an unconditional jump. 

The xb command is allowed only if it is read from some- 
place other than a terminal. If it is read from a pipe only 
a downward jump is possible. 


xt number 


Output from the p and null commands is truncated to at 
most number characters. The initial number is 255. 


xv[ digit] [spaces |[value] 


The variable name is the specified digit following the xv. 
The commands xv5100 or xv5 100 both assign the value 
100 to the variable 5 . The command Xv61,100p assigns 
the value 1,100p to the variable 6 . To reference a vari- 
able, put a % in front of the variable name. For exam- 
ple, using the above assignments for variables 5 and 6: 
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1,%9p 
1,%9 
%6 


will all print the first 100 lines. 


g/%5ip 


would globally search for the characters 100 and print 
each line containing a match. To escape the special 
meaning of % , a \\ must precede it. 


g/".*\%[cds]/p 


could be used to match and list lines containing printf of 
characters, decimal integers, or strings. 

Another feature of the xv command is that the first line 
of output from a UNIX system command can be stored 
into a variable. The only requirement is that the first 
character of va/ue be an !. For example: 


.W junk 

xv5!cat junk 

Irm junk 

lecho "%9" 
xv6lexpr %6 + 1 


would put the current line into variable 5, print it, and 
increment the variable 6 by one. To escape the special 
meaning of ! as the first character of value , precede it 
with a \. 


xv/\ldate 
stores the value !date into variable 7. 
xbz /abe/ 


xbn /abel 
These two commands will test the last saved return 
code from the execution of a UNIX system command 
(!Ccommand) or nonzero value, respectively, to the speci- 
fied label. The two examples below both search for the 
next five lines containing the string size. 


xV55 


: | 
/size/ 
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xv5lexpr %5 — 1 

lif O%5 '= 0 exit 2 
xbn | 

xv45 

| 
/size/ 

xv4lexpr %4 — 1 
lif 0%4 = O exit 2 
xbz | 


BFS(1) 


lf switch is 1, output from the p and null commands is 
crunched; if switch is 0 it is not. Without an argument, 
xe reverses switch. Initially switch is set for no crunch- 
ing. Crunched output has strings of tabs and blanks 


reduced to one blank and blank lines suppressed. 


SEE ALSO 
csplit(1), ed(1). 


regcmp(3X) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 


? for errors in commands, if prompting is turned off. Self- 


explanatory error messages when prompting is on. 
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bls — list contents of directory 


SYNOPSIS 


/usr/plx/bls [ —abcdfgilmaqrstux1CFR ] name ... 


DESCRIPTION 
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For each directory argument, bis lists the contents of the directory; 
for each file argument, b/s repeats its name and any other informa- 
tion requested. By default, the output is sorted alphabetically. 
When no argument is given, the current directory is listed. When 
several arguments are given, the arguments are first sorted 
appropriately, but file arguments appear before directories and their 
contents. 


There are three major listing formats. The format chosen depends 
on whether the output is going to a teletype, and may also be con- 
trolled by option flags. The default format for a teletype is to list the 
contents of directories in multi-column format, with the entries sorted 
down the columns. (Files that are not the contents of a directory 
being interpreted are always sorted across the page rather than 
down the page in columns. This is because the individual file 
names may be arbitrarily long.) If the standard output is not a tele- 
type, the default format is to list one entry per line. Finally, there is 
a stream output format in which files are listed across the page, 
separated by ‘,’ characters. The —m flag enables this format. 


This command has many options: 


I List in long format, giving mode, number of links, owner, 
size in bytes, and time of last modification for each file. 
(See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. 


—t Sort by time modified (latest first) instead of by name, as is 
normal. 

—a List all entries; usually «.. and '... are suppressed. 

—-S Give size in (1024-byte) blocks, including indirect blocks, for 
each entry. 

-d lf argument is a directory, list only its name, not its contents 


(mostly used with -I to get status on directory). 


—r Reverse the order of sort to get reverse alphabetic or oldest 
first as appropriate. 


—U Use time of last access instead of last modification for sort- 
ing (-t) or printing (-I). 
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-m 
-1 


—X 


-F 


—-R 


(Plexus) BLS(1) 


Use time of file creation for sorting or printing. 


Print i-number in first column of the report for each file 
listed. 


Force each argument to be interpreted as a directory and 
list the name found in each slot. This option turns off -I, -t, 
—S, and -r, and turns on —a; the order is the order in which 
entries appear in the directory. 


Give group ID instead of owner ID in long listing. 

Force stream output format. 

Force one entry per line output format, e.g. to a teletype. 
Force multi-column output, e.g. to a file or a pipe. 


Force printing of non-graphic characters in file names as the 
character ‘?’; this normally happens only if the output device 
is a teletype. 


Force printing of non-graphic characters to be in the \ddd 
rotation, in octal. 


Force columnar printing to be sorted across rather than 
down the page; this is the default if the last character of the 
name the program is invoked with is an ‘x’. 


Cause directories to be marked with a trailing ‘/” and execut- 
able files to be marked with a trailing *; this is the default if 
the last character of the name the program is invoked with 
isa f. 

Recursively list subdirectories encountered. 


The mode printed under the -I option contains 11 characters, which 
are interpreted as follows: the first character is 


d 


b 
Cc 
m 


if the entry is a directory; 

if the entry is a block-type special file; 

if the entry is a character-type special file; 

if the entry is a multiplexor-type character special file; 
if the entry is a plain file. 


The next 9 characters are interpreted as three sets of three bits 
each. The first set refers to owner permissions; the next to permis- 
sions to others in the same user-group; and the last to all others. 
Within each set the three characters indicate permission respec- 
tively to read, to write, or to execute the file as a program. For a 
directory, ‘execute’ permission is interpreted to mean permission to 
search the directory for a specified file. The permissions are indi- 
cated as follows: 
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FILES 


NOTES 


BUGS 
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if the file is readable; 

if the file is writable; 

if the file is executable; 

if the indicated permission is not granted. 


[xs 7 


The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise the user-execute permission character 
is given as $ if the file has set-user-ID mode. 


The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit 
of the mode is on. See chmod(1) for the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks is printed. 


/etc/passwd to get user ID's for ‘bis -l’. 
/etc/group to get group !ID’s for ‘bls —9’. 


This command is based on the /s command from the University of 
California at Berkeley. 


Newline and tab are considered printing characters in file names. 
The output device is assumed to be 80 columns wide. 


The option setting based on whether the output is a teletype is 
undesirable, because “bls -s” is very different from “bls —s| lpr”. 
On the other hand, not doing this setting would make old shell 
scripts that used /s almost certain not to work. 


Column widths choices are poor for terminals that can tab. 
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bs — a compiler/interpreter for modest-sized programs 


SYNOPSIS 


bs [ file [ args ] ] 


DESCRIPTION 


Bs is a remote descendant of Basic and Snobol4 with a little C 
language thrown in. Bs is designed for programming tasks where 


- program development time is as important as the resulting speed of 
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execution. Formalities of data declaration and file/process manipu- 
lation are minimized. Line-at-a-time debugging, the trace and 
dump statements, and useful run-time error messages all simplify 
program testing. Furthermore, incomplete programs can be 
debugged; inner functions can be tested before outer functions 
have been written and vice versa. 


If the command line fife argument is provided, the file is used for 
input before the console is read. By default, statements read from 
the file argument are compiled for later execution. Likewise, state- 
ments entered from the console are normally executed immediately 
(see compile and execute below). Unless the final operation is 
assignment, the result of an immediate expression statement is 
printed. 


Bs programs are made up of input lines. If the last character on a 
line is a \, the line is continued. 8s accepts lines of the following 
form: 


statement 
label statement 


A label is a name (see below) followed by a colon. A label and a 
variable can have the same name. 


A bs statement is either an expression or a keyword followed by 
zero or more expressions. Some keywords (clear, compile , ! , 
execute , include , ibase , obase , and run ) are always executed 
as they are compiled. 


Statement Syntax: 


expression 
The expression is executed for its side effects (value, assign- 
ment, or function call). The details of expressions follow the 
description of statement types below. 


break | 
Break exits from the inner-most for/while loop. 
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clear 
Clears the symbol table and compiled statements. Clear is exe- 
cuted immediately. 


compile [ expression | 
Succeeding statements are compiled (overrides the immediate 
execution default). The optional expression is evaluated and 
used as a file name for further input. A clear is associated with 
this latter case. Compile is executed immediately. 


continue 
Continue transfers to the loop-continuation of the current 
for/while loop. 


dump [ name ] 
The name and current value of every non-local variable is 
printed. Optionally, only the named variable is reported. After 
an error or interrupt, the number of the last statement and (pos- 
sibly) the user-function trace are displayed. 


exit [ expression | 
Return to system level. The expression is returned as process 
status. 


execute 
Change to immediate execution mode (an interrupt has a similar 
effect). This statement does not cause stored statements to 
execute (see run below). 


for name = expression expression statement 
for name = expression expression 


next 


for expression , expression , expression statement 


for expression , expression , expression 


next 

The for statement repetitively executes a statement (first form) 
or a group of statements (second form) under control of a named 
variable. The variable takes on the value of the first expression, 
then is incremented by one on each loop, not to exceed the 
value of the second expression. The third and fourth forms 
require three expressions separated by commas. The first of 
these is the initialization, the second Is the test (true to continue), 
and the third is the loop-continuation action (normally an incre- 
ment). 
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fun f({a,...])[v,...] 


nuf 
Fun defines the function name, arguments, and local variables 
for a user-written function. Up to ten arguments and local vari- 
ables are allowed. Such names cannot be arrays, nor can they 
~ be 1/O associated. Function definitions may not be nested. 


freturn 
A way to signal the failure of a user-written function. See the 
interrogation operator (?) below. If interrogation is not present, 
freturn merely returns zero. When interrogation is active, freturn 
transfers to that expression (possibly by-passing intermediate 
function returns). 


goto name 
Control is passed to the internally stored statement with the 
matching label. 


ibase N 
lbase sets the input base (radix) to N . The only supported 
values for N are 8 , 10 (the default), and 16 . Hexadecimal 
values 10-15 are entered as a —f. A leading digit is required 
(i.e., f0a must be entered as Of0a ). /oase (and obase , below) 
are executed immediately. 


if expression statement 
if expression 


[ else 
| 

fi 
The statement (first form) or group of statements (second form) 
is executed if the expression evaluates to non-zero. The strings 
0 and “" (null) evaluate as zero. In the second form, an optional 
else allows for a group of statements to be executed when the 
first group is not. The only statement permitted on the same line 
with an e/se is an /f ; only other fi ’s can be on the same line 
with a fi. The elision of else and /f into an elif is supported. 
Only a single fi is required to close an "if... elif..." "["" else... 
""1l sequence." 


include expression 
The expression must evaluate to a file name. The file must con- 
tain bs source statements. Such statements become part of the 
program being compiled. /nclude statements may not be 
nested. 
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( | obase N 
_ Obase sets the output base to N (see base above). 


onintr label 

onintr 
The onintr command provides program control of interrupts. In 
the first form, control will pass to the label given, just as if a goto 
had been executed at the time onintr was executed. The effect 
of the statement is cleared after each interrupt. In the second 
form, an interrupt will cause bs to terminate. 


return [expression] 
The expression is evaluated and the result is passed back as the 
value of a function call. If no expression is given, zero is 
returned. 


run 
The random number generator is reset. Control is passed to the 
first internal statement. If the run statement is contained in a 
file, it should be the last statement. 


stop 
Execution of internal statements is stopped. 8s reverts to 
( immediate mode. 


trace [ expression | 
The trace statement controls function tracing. If the expression 
is null (or evaluates to zero), tracing is turned off. Otherwise, a 
record of user-function calls/returns will be printed. Each return 
decrements the frace expression value. | 


while expression statement 
while expression 


next 
While is similar to for except that only the conditional expression 
for loop-continuation is given. 


! shell command 
An immediate escape to the Shell. 


#... 
This statement is ignored. It is used to interject commentary in a 
program. 


Expression Syntax: 


2, name 
( - A name is used to specify a variable. Names are composed of a 
a letter (upper or lower case) optionally followed by letters and 
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digits. Only the first six characters of a name are significant. 
Except for names declared in fun statements, all names are glo- 
bal to the program. Names can take on numeric (double float) 
values, string values, or can be associated with input/output (see 
the built-in function open () below). 


name { [expression [ , expression] ... ] ) 
Functions can be called by a name followed by the arguments in 
parentheses separated by commas. Except for built-in functions 
(listed below), the name must be defined with a fun statement. 
Arguments to functions are passed by value. 


name [ expression [ , expression]... ] 
This syntax is used to reference either arrays or tables (see 
built-in table functions below). For arrays, each expression is 
truncated to an integer and used as a Specifier for the name. 
The resulting array reference is syntactically identical to a name; 
a({1,2] is the same as a[1][2] . The truncated expressions are 
restricted to values between 0 and 32767. 


number 
A number is used to represent a constant value. A number is 
written in Fortran style, and contains digits, an optional decimal 
point, and possibly a scale factor consisting of an e followed by a 
possibly signed exponent. _ 


string 
Character strings are delimited by “ characters. The \ escape 
character allows the double quote (\"), new-line (\n), Carriage 
return (\r), backspace (\b), and tab (\t) characters to appear in a 
string. Otherwise, \ stands for itself. 


( expression ) 
Parentheses are used to alter the normal order of evaluation. 


( expression, expression [, expression ... ] ) [ expression ] 
The bracketed expression is used as a subscript to select a 
comma-separated expression from the parenthesized list. List 
elements are numbered from the left, starting at zero. The 
expression: 


( False, True )[ a == b] 
has the value True if the comparison is true. 


? expression 
The interrogation operator tests for the success of the expres- 
sion rather than its value. At the moment, it is useful for testing 
end-of-file (see examples in the Programming Tips section 
below), the result of the eval built-in function, and for checking 


May 22, 1985 


ae 


: / 
Se 


BS(1) UNIX Sys5 BS(1) 


( | the return from user-written functions (see freturn ). An interro- 
. gation “trap” (end-of-file, etc.) causes an immediate transfer to 
the most recent interrogation, possibly skipping assignment 
statements or intervening function levels. 


— expression 
The result is the negation of the expression. 


++ name 
Increments the value of the variable (or array reference). The 
result is the new value. 


— name 
Decrements the value of the variable. The result is the new 
value. 


! expression 
The logical negation of the expression. Watch out for the shell 
escape command. 


expression operator expression 
Common functions of two arguments are abbreviated by the two 
arguments separated by an operator denoting the function. 
= Except for the assignment, concatenation, and relational opera- 
( tors, both operands are converted to numeric form before the 
function is applied. 


Binary Operators (in increasing precedence): 


= is the assignment operator. The left operand must be a name 
or an array element. The result is the right operand. Assign- 
ment binds right to left, all other operators bind left to right. 


_ (underscore) is the concatenation operator. 


& (logical and) has result zero if either of its arguments are zero. 
It has result one if both of its arguments are non-zero; | (logical 
or) has result zero if both of its arguments are zero. It has result 
one if either of its arguments is non-zero. Both operators treat a 
null string as a zero. 


< <= > >= == I> 
The relational operators (< less than, <= less than or equal, > 
greater than, >= greater than or equal, = = equal to, != not 
fax equal to) return one if their arguments are in the specified rela- 
( tion. They return zero otherwise. Relational operators at the 
Ke same level extend as follows: a>b>c is the same as a>b & 
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b>c . A string comparison is made if both operands are strings. or 
+ — | Ne 
Add and subtract. 
* | %G% 


Multiply, divide, and remainder. 


Exponentiation. 
Built-in Functions: 
Dealing with arguments 


arg(i) 
is the value of the / -th actual parameter on the current level of 
function call. At level zero, arg returns the / -th command-line 
argument (arg(0) returns bs ). 


narg() 
returns the number of arguments passed. At level zero, the 


command argument count is returned. 


Mathematical 
abs(x) ye 
is the absolute value of x . y 
atan(x) | / 
is the arctangent of x . Its value is between —7/2 and 7/2. 
ceil(x) 
returns the smallest integer not less than x. 
cos(x) 
is the cosine of x (radians). 
exp(x) | 
is the exponential function of x . 
floor(x) | 
returns the largest integer not greater than x . 
log(x) 
is the natural logarithm of x. 
rand() 
is a uniformly distributed random number between zero and one. 
sin(x) 
is the sine of x (radians). 
sqrt(x) -_ 
<< 9 


is the square root of x. 
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( " String operations 


size(s) 
the size (length in bytes) of s is returned. 


format(f, a) 
returns the formatted value of a . F is assumed to be a format 
specification in the style of printf (3S). Only the %...f, %...e, 
and %...S types are safe. 


index(x, y) 
returns the number of the first position in x that any of the char- 
acters from y matches. No match yields zero. 


trans(s, f, t) 
Translates characters of the source s from matching characters 
in f to a character in the same position in t . Source characters 
that do not appear in f are copied to the result. If the string f is 
longer than f , source characters that match in the excess por- 
tion of f do not appear in the result. 


substr(s, start, width) 
returns the sub-string of s defined by the start ing position and 
width . 


( match(string, pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ed 
(1) command. The characters ., [, ], * (inside brackets), * and $ 
are special. The mstring function returns the n-th (1 <=n <= 
10) substring of the subject that occurred between pairs of the 
pattern symbols \( and \) for the most recent call to match . To 
succeed, patterns must match the beginning of the string (as if 
all patterns began with *). The function returns the number of 
characters matched. For example: 


match("a123ab123", °.*\([a-z]\)") == 6 
mstring(1) == "b" 


File handling 


open(name, file, function) 
close(name) 

The name argument must be a bs variable name (passed as a 
string). For the open , the file argument may be 1) a 0 (zero), 
1, or 2 representing standard input, output, or error output, 
respectively; 2) a string representing a file name; or 3) a 
a string beginning with an ! representing a command to be exe- 
( cuted (via sh -c ). The function argument must be either r 
(read), w (write), W (write without new-line), or a (append). After 
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a close , the name reverts to being an ordinary variable. The ini- 
tial associations are: 


open("get", 0, "r") 
open(“put", 1, “w") 
open("puterr’, 2, "w") 


Examples are given in the following section. 


access(s, m) 
executes access (2). 


ftype(s) 
returns a single character file type indication: f for regular file, p 
for FIFO (i.e., named pipe), d for directory, b for block special, or 
c for character special. 


Tables 


table(name, size) | 
A table in bs is an associatively accessed, single-dimension 
array. “Subscripts” (called keys) are strings (numbers are con- 
verted). The name argument must be a bs variable name 
(passed as a string). The size argument sets the minimum 
number of elements to be allocated. Bs prints an error message 
and stops on table overflow. 


item(name, i) 


key() 
The item function accesses table elements sequentially (in nor- 


mal use, there is no orderly progression of key values). Where 
the item function accesses values, the key function accesses 
the “subscript” of the previous item call. The name argument 
should not be quoted. Since exact table sizes are not defined, 
the interrogation operator should be used to detect end-of-table; 
for example: | 


table("t", 100) 


# |f word contains "party", the following expression adds 
one 

# to the count of that word: 

+ + t[word] 


# To print out the the key/value pairs: 


for i = 0, ?(s = item(t, i)), ++i if key() put = 
key()_":"_s | 
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( . iskey(name, word ) 
s The iskey function tests whether the key word exists in the table 
name and returns one for true, zero for false. 


Odds and ends 


eval(s) 

The string argument is evaluated as a bs expression. The func- 
tion is handy for converting numeric strings to numeric internal 
form. Eval can also be used as a crude form of indirection, as 
In: 

name = “xyz” 

eval("+ +"_ name) 
which increments the variable xyz . In addition, eva/ preceded by 
the interrogation operator permits the user to control bs error 
conditions. For example: 

Peval(“open(\"X\"", \"XXX\", \"r\")") 


returns the value zero if there is no file named “XXX” (instead of 
halting the user's program). The following executes a goto to 
the label L (if it exists): 


( label -"L" 
: if (?eval("goto "_ label)) puterr = "no label” 


plot(request, args) 
The plot function produces output on devices recognized by 
tplot (1G). The requests are as follows: 


Call Function 


plot(O, term) causes further p/ot output to 
be piped into tplot (1G) with 
an argument of —Tterm. 


plot(4) “erases the plotter. 

plot(2, string) labels the current point with 
string . 

plot(3, x1, y1, x2, y2) draws the line between 
(x7,y7) and (x2,y2). 

plot(4, x, y, r) draws a circle with center 


(x,y) and radius r. 


plot(5, x1, y1, x2, y2, x3, y3) draws an arc (counterclock- 

pr wise) with center (x7,y7) 

( | and endpoints (x2,y2) and 
(x3,y3). 
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plot(6) 
plot(7, x, y) 


plot(8, x, y) 


plot(9, x, y) 
plot(10, string) 
plot(11, x1, y1, x2, y2) 


plot(12, x1, y1, x2, y2) 


BS(1) 


is not implemented. — 


makes the current point 
(x,y). 

draws a line from the current 
point to (x,y). 


draws a point at (x,y). 
sets the line mode to string . 


makes (x7,y7) the lower left 
corner of the plotting area 
and (x2,y2) the upper right 
corner of the plotting area. 


causes subsequent x (y) 
coordinates to be multiplied 
by x7 (y7) and then added 
to x2 (y2) before they are 
plotted. The initial scaling is 
plot(12, 1.0, 1.0, 0.0, 0.0) . 


Some requests do not apply to all plotters. All requests except 
zero and twelve are implemented by piping characters to tp/ot 


(1G). See plot (4) for more details. 
last() 


in immediate mode, last returns the most recently computed 


value. 


PROGRAMMING TIPS 
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Using bs as a calculator: 
$ bs 


# Distance (inches) light travels in a nanosecond. 


186000 « 5280 * 12 / 1e9 
11.78496 


# Compound interest (6% for 5 years on $1,000). 


int = .06/ 4 
bal = 1000 
fori = 15*4 bal = bal + bal-int 
bal — 1000 
— 346.855007 
exit 


The outline of a typical bs program: 
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# initialize things: 
vari = 1 
open("read", “infile”, “r’) 


# compute: 
while ?(str = read) 


next 
# clean up: 
close("read") 


# last statement executed (exit or stop): 
exit 

# last input line: 

run 


Input/Output examples: 


# Copy "oldfile" to "newfile”. 
open("read", “oldfile", “r') 
open(‘write”, “newfile", “w") 


while ?(write = read) 


# Close "read" and "write": 
close("read") 
close(‘write") 


# Pipe between commands. 
open(‘Is", “Hs #", “r") 

open("pr”, “lpr —2 —-h ‘List’’, “w") 
while ?(pr = Is) . 


# be sure to close (wait for) these: 
close(‘Is") 
close("pr") 


SEE ALSO 
ed(1), sh(1), tplot(1G). 
access(2), printf(3S), stdio(3S), plot(4) in the “Sys5 UNIX Program- 
mer Reference Manual" . 
See Section 3 of the Sys5 UNIX Programmer Reference Manual for 
a further description of the mathematical functions (pow on exp 
(3M) is used for exponentiation); bs uses the Standard Input/Output 
package. | 
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NAME | a 
cal — print calendar Me 
SYNOPSIS 
cal [ [ month ] year |] 
DESCRIPTION 


Cal prints a calendar for the specified year. If a month is also 

specified, a calendar just for that month is printed. If neither is | 
specified, a calendar for the present month is printed. Year can be 

between 1 and 9999. The month is a number between 1 and 12. 

The calendar produced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even though this 
is historically naive. 
Beware that “cal 83” refers to the early Christian era, not the 20th 
century. 
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( NAME 
at calendar — reminder service 
SYNOPSIS 
calendar [ — | 
DESCRIPTION 


Calendar consults the file calendar in the current directory and 
prints out lines that contain today’s or tomorrow's date anywhere in 
the line. Most reasonable month-day dates such as “Aug. 24,” 
“august 24,” “8/24,” etc., are recognized, but not “24 August’ or 
“24/8”. On weekends “tomorrow” extends through Monday. 


When an argument is present, calendar does its job for every user 
who has a file calendar in the login directory and sends them any 
positive results by mail (1). Normally this is done daily by facilities in 
the UNIX operating system. 


FILES 
/usr/lib/calprog to figure out today’s and tomorrow's dates 


/etc/passwd 


oe /tmp/cal* 
( SEE ALSO 


mail(1). 


BUGS 
Your calendar must be public information for you to get reminder 
service. 
Calendar’s extended idea of “tomorrow” does not account for holi- 
days. 
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NAME 

cat — concatenate and print files 
SYNOPSIS 

cat [ -u | [ -s ] file ... 


DESCRIPTION 
Cat reads each file in sequence and writes it on the standard out- 
put. Thus: 


cat file 
prints the file, and: 
cat file1 file2 >file3 
concatenates the first two files and places the result on the third. 


If no input file is given, or if the argument — is encountered, cat 
reads from the standard input file. Output is buffered in 512-byte 
blocks unless the —u option is specified. The -—s option makes cat 
silent about non-existent files. No input file may be the same as the 
output file unless it is a special file. 


NOTES 
Plexus provides a standalone version of cat in addition to the one 
that runs under Sys5. 

SEE ALSO 
cp(1), pr(1). 
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cb — C program beautifier 


SYNOPSIS 


cb [-s][-j][-I leng ] [ file ... ] 


DESCRIPTION 


Cb reads C programs either from its arguments or from the stan- 
dard input and writes them on the standard output with spacing and 
indentation that displays the structure of the code. Under default 
options, cb preserves all user new-lines. Under the —s flag cb 
Ccanonicalizes the code to the style of Kernighan and Ritchie in The 
C Programming Language . The -j flag causes split lines to be put 
back together. The —I flag causes cb to split lines that are longer 
than /eng . 


SEE ALSO 


BUGS 
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The C Programming Language by B. W. Kernighan and D. M. 
Ritchie. 


Punctuation that is hidden in preprocessor statements will cause 
indentation errors. 
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cc, pcc — C compiler 
SYNOPSIS 
cc [ option | ... file ... 
pcc [ option ] ... file ... 
DESCRIPTION 
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Cc is the UNIX system C compiler. It accepts several types of argu- 
ments. 


Arguments whose names end with .c are taken to be C source pro- 
grams. They are compiled, and each object program is left on the 
file whose name is that of the source with .o substituted for .c. The 
.O file is normally deleted, however, if a single C program is com- 
piled and loaded all at one go. 


In the same way, arguments whose names end with .s are taken to 
be assembly source programs and are assembled, producing a .o 
file. | 


The following options are interpreted by cc and pcc . See /d (7) for 
link editor options and cpp (7) for more preprocessor options. 


—C Suppress the link edit phase of the compilation and force 
an object file to be produced even if only one program is 
compiled. 

—p Arrange for the compiler to produce code that counts the 


number of times each routine is called; also, if link editing 
takes place, replace the standard startoff routine by one 
that automatically calls monitor (3C) at the start and 
arranges to write out a mon.out file at normal termination 
of execution of the object program. An execution profile 
can then be generated by use of prof (7). 


—f Link the object program with the floating-point interpreter 
for systems without hardware floating-point. 

-g Cause the compiler to generate additional information 
needed for the use of cdb. 

-O Invoke an object-code optimizer. 

-S Compile the named C programs and leave the assembler- 


language output on corresponding files suffixed .s. 


-E Run only cpp (17) on the named C programs and send the 
result to the standard output. 


—P Run only cpp (7) on the named C programs and leave the 
result on corresponding files suffixed .i. 
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—Bstring 
Construct pathnames for substitute preprocessor, compiler, 
assembler and link editor passes by concatenating string 
with the suffixes cpp , c0 (or ccom or comp , see under 
FILES below), c1 , c2 (or optim ), as and Id . If string is 
empty it is taken to be /lib/o . 


—t [ p012al ] 
Find only the designated preprocessor, compiler, assem- 
bler and link editor passes in the files whose names are 
constructed by a —B option. In the absence of a —B option, 
the string is taken to be /lib/n . The value -t "" is 
equivalent to —tp012 . 


-—Wce,arg1[,arg2...] 
Hand off the argument[s] argi to pass c where c is one of 
[p012al] indicating preprocessor, compiler first pass, com- 
piler second pass, optimizer, assembler, or link editor, 
respectively. 


Other arguments are taken to be either link editor option arguments, 
C preprocessor option arguments, or C-compatible object programs, 
typically produced by an earlier cc or pcc run, or perhaps libraries 
of C-compatible routines. These programs, together with the results 


of any compilations specified, are linked (in the order given) to pro- 


duce an executable program with the name a.out . 


file.c input file 
file.o object file 
~ a.out linked output 

/tmp/ctm* temporary 

/usr/tmp/ctm* temporary 

/lib/cpp C preprocessor cpp (1) 

/usr/lib/comp compiler, pcc 

/ust/lib/Oc* backup compiler, Occ 

/bin/as assembler, as (7) 

/bin/Id link editor, Id (1) 

[lib/crt0.0 runtime startoff 

/lib/mert0.o profiling startoff 

/ib/fcrt0.o floating-point interpretation startoff 

[ib/fmert0.o floating-point interpretation and profiling 
startoff 

/lib/libc.a standard C library, see section (3) in the 
Sys5 UNIX (3) Programmer’s Reference 
Manual | 

[ib/libp/ib*.a profiled versions of libraries 
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SEE ALSO 
adb(1), cpp(1), as(1), Id(1), prof(1). 
exit(2), monitor(3C) in the Sys5 UNIX Programmer Reference 
Manual. 


The C Programming Language by B. W. Kernighan. 
Programming in C-A Tutorial by B. W. Kernighan. 
C Reference Manual by D. M. Ritchie. 


NOTES 
By default, the return value from a C program is completely random. 
The only two guaranteed ways to return a specific value are to expli- 
citly call exit (2) or to leave the function main ( ) with a “return 
expression ;’’ construct. 


DIAGNOSTICS | 
The diagnostics produced by C itself are intended to be self- 
explanatory. Occasional messages may be produced by the 
assembler or the link editor. m , which means a multiply-defined 
external symbol (function or data). 
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cd — change working directory 


SYNOPSIS 


cd [ directory | 


DESCRIPTION 


lf directory is not specified, the value of shell parameter $HOME is 
used as the new working directory. If directory specifies a complete 
path starting with / , . , .. , directory becomes the new working 
directory. If neither case applies, cd tries to find the designated 
directory relative to one of the paths specified by the $CDPATH shell 
variable. $CDPATH has the same syntax as, and similar semantics 
to, the $PATH shell variable. Cd must have execute (search) per- 
mission in directory . 


Because a new process is created to execute each command, cd 
would be ineffective if it were written as a normal command; there- 
fore, it is recognized and is internal to the shell. 


SEE ALSO 
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pwd(1), sh(1). 
chdir(2) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
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cdc — change the delta commentary of an SCCS delta 


SYNOPSIS 


cde -rSiD [—m[mrlist]] [—y[comment]] files 


DESCRIPTION 
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Cdc changes the delta commentary , for the SID specified by the -r 
keyletter, of each named SCCS file. 


Delta commentary is defined to be the Modification Request (MR) 
and comment information normally specified via the delta (1) com- 
mand (—m and —y keyletters). 


lf a directory is named, cdc behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files 
(last Component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of — is given, the 
standard input is read (see WARNINGS); each line of the standard 
input is taken to be the name of an SCCS file to be processed. 


Arguments to cdc , which may appear in any order, consist of 
keyletter arguments and file names. 


All the described keyletter arguments apply independently to each 
named file: 


-rS/D Used to specify the S CCS I/D entification 
(SID) string of a delta for which the delta com- 
mentary is to be changed. 


—m([mriist] If the SCCS file has the v flag. set (see admin 
(1)) then a list of MR numbers to be added 
and/or deleted in the delta commentary of the 
SID specified by the -r keyletter may be sup- 
plied. A null MR list has no effect. 


MR entries are added to the list of MRs in the 
same manner as that of delta (1). In order to 
delete an MR, precede the MR number with 
the character ! (see EXAMPLES). If the MR to 
be deleted is currently in the list of MRs, it is 
removed and changed into a “comment” line. 
A list of all deleted MRs is placed in the com- 
ment section of the delta commentary and 
preceded by a comment line stating that they 
were deleted. 


lf -m is not used and the standard input is a 
terminal, the prompt MRS? is issued on the 
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standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRs? prompt 
always precedes the comments? prompt 
(see —y keyletter). 


MRs in a list are separated by blanks and/or 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 


Note that if the v flag has a value (see admin 
(1)), it is taken to be the name of a program 
(or shell procedure) which validates the 
correctness of the MR numbers. If a non- 
zero exit status is returned from the MR 
Number validation program, cdc terminates 
and the delta commentary’ remains 
unchanged. 


Arbitrary text used to replace the comment(s) 
already existing for the delta specified by the 
-r keyietter. The previous comments are 
kept and preceded by a comment line stating 
that they were changed. A null comment has 
no effect. 


lf -y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 


The exact permissions necessary to modify the SCCS file are 
documented in the Source Code Control System User Guide . 
Simply stated, they are either (1) if you made the delta, you 
can change its delta commentary; or (2) if you own the file and 
directory you can modify the delta commentary. 
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EXAMPLES 
cde -r1.6 —m"bl78-12345 !bI77-54321 bli79-00001" —ytrouble 
S.file 


adds bl78-12345 and bI79-00001 to the MR list, removes bI77-54321 
from the MR list, and adds the comment trouble to delta 1.6 of 
S.file. 

cdc -1r1.6 s.file 


MRs? !bI77-54321 bI78-12345 bI79-00001 
comments? trouble 


does the same thing. 


WARNINGS 
If SCCS file names are supplied to the cdc command via the stan- 
dard input (— on the command line), then the —m and -y keyletters 
must also be used. 


FILES 
x-file (see delta (1)) 
z-file (see delta (1)) 
SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 
DIAGNOSTICS 


Use help (1) for explanations. 
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NAME 


cflow— generate C flow graph 


SYNOPSIS 


cflow [—r] [-ix] [-i_ ] [-dnum] files 


DESCRIPTION 
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Cflow analyzes a collection of C, YACC, LEX, assembler, and object 
files and attempts to build a graph charting the external references. 
Files suffixed in .y , .l_, .c , and .i are YACC'd, LEX’d, and C- 
preprocessed (bypassed for .i files) as appropriate and then run 
through the first pass of fint (7). (The -1, -—D , and —U options of the 
C-preprocessor are also understood.) Files suffixed with .s are 
assembled and information is extracted (as in .o files) from the sym- 
bol table. The output of all this non-trivial processing is collected 
and turned into a graph of external references which is displayed 
upon the standard output. 


Each line of output begins with a reference (i.e., line) number, fol- 
lowed by a Suitable number of tabs indicating the level. Then the 
name of the global (normally only a function not defined as an exter- 
nal or beginning with an underscore; see below for the —i inclusion 
option) a colon and its definition. For information extracted from C 
source, the definition consists of an abstract type declaration (e.g., 
char * ), and, delimited by angle brackets, the name of the source 
file and the line number where the definition was found. Definitions 
extracted from object files indicate the file name and location 
counter under which the symbol appeared (e.g., fext ). Leading 
underscores in C-style external names are deleted. 


Once a definition of a name has been printed, subsequent refer- 
ences to that name contain only the reference number of the line 
where the definition may be found. For undefined references, only 
<> is printed. As an example, given the following in file.c : 


int e 
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I 


the command 
cflow —ix file.c 
produces the output 


main: int(), <file.c 4> 
f: int(), <file.c 11> 
h: <> 
i: int, <file.c 1> 
g: <> 


mh Oh — 


When the nesting level becomes too deep, the —e option of pr (7) 
can be used to compress the tab expansion to something less than 
every eight spaces. | 

The following options are interpreted by cflow : 


-f Reverse the “caller:callee’” relationship producing an 
inverted listing showing the callers of each function. The 
listing is also sorted in lexicographical order by callee. 


—ix Include external and static data symbols. The default is to 
include only functions in the flowgraph. 


-i_ Include names that begin with an underscore. The default is 
to exclude these functions (and data if -/x is used). 
-—d num 
The num decimal integer indicates the depth at which the 
flowgraph is cut off. By default this is a very large number. 
Attempts to set the cutoff depth to a nonpositive integer will 
be met with contempt. 
DIAGNOSTICS 
Complains about bad options. Complains about multiple definitions 
and only believes the first. Other messages may come from the 
various programs used (e.g., the C-preprocessor). 
SEE ALSO 
as(1), cc(1), cpp(1), lex(1), lint(1), nm(1), pr(1), yacc(1). 
BUGS 
Files produced by /ex (7) and yacc (1) cause the reordering of line 


number declarations which can confuse cflow . To get proper 
results, feed cflow the yacc or /ex input. 
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NAME 


chmod — change mode 


SYNOPSIS 


chmod mode files 


DESCRIPTION 
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The permissions of the named files are changed according to mode 
, which may be absolute or symbolic. An absolute mode is an octal 
number constructed from the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod (2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 
0007 read, write, execute (Search) by others 


A symbolic mode has the form: 
[ who ] op permission [ ] 


The who part is a combination of the letters u (for user’s permis- 
sions), g (group) and o (other). The letter a stands for ugo , the 
default if who is omitted. 


Op can be + to add permission to the file’s mode, — to take away 
permission , or = to assign permission absolutely (all other bits will 
be reset). 


Permission is any combination of the letters r (read), w (write), x 
(execute), s (set owner or group ID) and t (save text, or sticky); u, 
g , Or O indicate that permission is to be taken from the current 
mode. Omitting permission is only useful with = to take away all 
permissions. 


Multiple symbolic modes separated by commas may be given. 
Operations are performed in the order specified. The letter s is only 
useful with u or g and t only works with u. 


Only the owner of a file (or the super-user) may change its mode. 
Only the super-user may set the sticky bit. In order to set the group 
ID, the group of the file must correspond to your current group ID. 
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EXAMPLES . , 
The first example denies write permission to others, the second 
makes a file executable: 


chmod o—-w file 
chmod +x file 


SEE ALSO 
Is(1). 
chmod(2) in the Sys5 UNIX Programmer Reference Manual. 
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( NAME 
= chown, chgrp — change owner or group 


SYNOPSIS 
chown owner file ... 


chgrp group file ... 


DESCRIPTION 
Chown changes the owner of the files to owner . The owner may be 
either a decimal user ID or a login name found in the password file. 


Chgrp changes the group ID of the files to group . The group may 
be either a decimal group ID or a group name found in the group 
file. 


If either command is invoked by other than the super-user, the set- 
user-ID and set-group-ID bits of the file mode, 04000 and 02000 
respectively, will be cleared. 


FILES 
/etc/passwd 
/etc/group 


SEE ALSO 


chmod(1). 
LC chown(2), group(4), passwd(4) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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NAME 
clear — clear terminal screen 


SYNOPSIS 
/usr/plx/clear 


DESCRIPTION 3 
Clear clears your screen if this is possible. It looks in the environ- 


ment for the terminal type and then in /etc/termcap to figure out. 


_ how to clear the screen. 


FILES 
/etc/termcap — terminal capability data base 


NOTES | 
This command is based on a similar one developed at the University 
of California at Berkeley. 
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NAME 
cmp — compare two files 


SYNOPSIS 
cmp [ -I ] [ -s ] [ -b buf_blocks ] file1 file2 


DESCRIPTION 
The two files are compared. (If file? is — , the standard input is 
used.) Under default options, cmp makes no comment if the files 
are the same; if they differ, it announces the byte and line number 
at which the difference occurred. If one file is an initial subse- 
quence of the other, that fact is noted. 


Options: 

—I Print the byte number (decimal) and the differing 
bytes (octal) for each difference. 

-S Print nothing for differing files; return codes only. 


-—b buf_blocks — Use input buffer of buf_blocks (decimal) blocks 
rather than the usual one block. This is useful for 
comparing a blocked tape. 


SEE ALSO 
comm(1), diff(1). 


( DIAGNOSTICS 
Exit code 0 is returned for identical files, 1 for different files, and 2 
for an inaccessible or missing argument. 
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NAME 

col — filter reverse line-feeds 
SYNOPSIS 

col [ —bfpx | 


DESCRIPTION 
Co! reads from the standard input and writes onto the standard out- 
put. It performs the line overlays implied by reverse line feeds 
(ASCII code ESC-7), and by forward and reverse half-line feeds 
(ESC-9 and ESC-8). Co/ is particularly useful for filtering mul- 
ticolumn output made with the .rt command of nroff and output 
resulting from use of the tb/ (7) preprocessor. 


If the —b option is given, co/ assumes that the output device in use 
is not capable of backspacing. In this case, if two or more charac- 
ters are to appear in the same place, only the last one read will be 
output. 


Although co/ accepts hailf-line motions in its input, it normally does 
not emit them on output. Instead, text that would appear between 
lines is moved to the next lower full-line boundary. This treatment 
can be suppressed by the -f (fine) option; in this case, the output 
from col may contain forward half-line feeds (ESC-9), but will still 
never contain either kind of reverse line motion. 


Unless the —x option is given, co/ will convert white space to tabs on 
output wherever possible to shorten printing time. 


The ASCH control characters SO (\016) and SI (\017) are assumed 
by co/ to start and end text in an alternate character set. The char- 
acter set to which each input character belongs is remembered, and 
on output SI and SO characters are generated as appropriate to 
ensure that each character is printed in the correct character set. 


On input, the only control characters accepted are space, back- 
space, tab, return, new-line, SI, SO, VT (\013), and ESC followed by 
7,8,0or9. The VT character is an alternate form of full reverse 
line-feed, included for compatibility with some earlier programs of 
this type. All other non-printing characters are ignored. 


Normally, co/ will ignore any unknown to it escape sequences found 
in its input; the —p option may be used to cause co/ to output these 
sequences as regular characters, subject to overprinting from 
reverse line motions. The use of this option is highly discouraged 
unless the user is fully aware of the textual position of the escape 
sequences. 


SEE ALSO 
nroff(1), tbi(1). 
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NOTES 
( The input format accepted by co/ matches the output produced by 
nroff with either the -T37 or —Tlp options. Use -—T37 (and the -f 
option of co/ ) if the ultimate disposition of the output of co/ will be a 
device that can interpret half-line motions, and —Tlp otherwise. 


BUGS 
Cannot back up more than 128 lines. 
Allows at most 800 characters, including backspaces, on a line. 
Local vertical motions that would result in backing up over the first 
line of the document are ignored. As a result, the first line must not 
have any superscripts. 


= \ 
( se 
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NAME 


comb — combine SCCS deltas 


SYNOPSIS 


comb [-o] [-s] [—psid] [—clist] files 


DESCRIPTION | 


Comb generates a shell procedure (see sh (7)) which, when run, 
will reconstruct the given SCCS files. The reconstructed files will, 
hopefully, be smaller than the original files. The arguments may be 
specified in any order, but all keyletter arguments apply to all named 
SCCS files. If a directory is named, comb behaves as though each 
file in the directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin with s.) 
and unreadable files are silently ignored. If a name of — is given, 
the standard input is read; each line of the input is taken to be the 
name of an SCCS file to be processed; non-SCCsSs files and unread- 
able files are silently ignored. The generated shell procedure is writ- 
ten on the standard output. 


The keyletter arguments are as follows. Each is explained as 


though only one named file is to be processed, but the effects of 
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any keyletter argument apply independently to each named file. 


-—pSsiD The S CCS /D entification string (SID) of the oldest delta to a 


be preserved. All older deltas are discarded in the recon- 
structed file. 


—clist A list (see get (1) for the syntax of a /ist) of deltas to be 
preserved. All other deltas are discarded. . 


-O For each get -e generated, this argument causes the 


reconstructed file to be accessed at the release of the delta 
to be created, otherwise the reconstructed file would be 
accessed at the most recent ancestor.. Use of the -—o 
keyletter may decrease the size of the reconstructed SCCS 
file. It may also alter the shape of the delta tree of the ori- 
ginal file. 


-S This argument causes comb to generate a shell procedure 
which, when run, will produce a report giving, for each file: 
the file name, size (in blocks) after combining, original size 
(also in blocks), and percentage change computed by: 

100 * (original — combined) / original 
It is recommended that before any SCCS files are actually 
combined, one should use this option to determine exactly 
how much space is saved by the combining process. 
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If no keyletter arguments are specified, comb will preserve 
only leaf deltas and the minimal number of ancestors 
needed to preserve the tree. 


FILES 
s.COMB The name of the reconstructed SCCS file. 
comb????? Temporary. 

SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1), sh(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 

DIAGNOSTICS 
Use help (1) for explanations. 

BUGS 


Comb may rearrange the shape of the tree of deltas. It may not 
save any space; in fact, it is possible for the reconstructed file to 
actually be larger than the original. 
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NAME - 3 —_ 
comm — select or reject lines common to two sorted files to 
SYNOPSIS 
comm [ — [ 123 ] | file1 file2 
DESCRIPTION 


Comm reads file? and file2 , which should be ordered in ASCII col- 
lating sequence (see sort (1)), and produces a three-column output: 
lines only in file7 ; lines only in file2 ; and lines in both files. The file 
name — means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. 
Thus comm -12 prints only the lines common to the two files; 
comm —23 prints only lines in the first file but not in the second; 
comm —123 is a no-op. 


SEE ALSO 
cmp(1), diff(1), sort(1), uniq(1). 
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NAME 
copytape — make an image copy of a tape 


SYNOPSIS 
/usr/plx/copytape [ —rwv ] [ —p numfiles ] [ —f filenum ] [ —d 
descfile ] { —i ] srcfile [ —o ] dstfile 


DESCRIPTION 

Copytape is used for duplicating tapes. It preserves blocking and file 
marks. The -r option specifies that srcfile (presumably a tape) is to 
be read and its data placed on dstfile. \f not otherwise specified, 
standard output contains the blocking and file mark information. The 
-w option (default) specifies that srcfile is to be read and dstfile 
(presumably a tape) is to be written according to information given as 
Standard input. 


The —v option (used with the -r option) specifies that variable size 
blocks may occur within a tape file. 


The -—p option must be used for the streaming tape drive, and the 
number of files to be read must be specified. A raw disk file system 
(e.g, /dev/dsk/0s3), aS opposed to a file, MUST be used when the 
streaming tape drive —p option is specified. On Plexus systems, —p 
works only if the system has installed an IMSP board. As a result, 
this option will not work on a P/15 or P/20. 


The -—f option specifies that a single file is to be read from or written 
to tape. The filenum selects the file from the srcfile, starting with file 
number 0. 


—i signals the input file, while -o means the output file. 


EXAMPLES 
The command 


copytape -r /dev/rrm/Om tapeimage > descfile 


makes an image of the tape in drive O in the file tapeimage while 
creating a description file called descfile. By loading a new tape and 
issuing the command 


copytape -w tapeimage /dev/rrm/Omn < descfile 


an exact image of the tape will be created. Notice that /dev/rrm/Omn 
is used instead of /dev/rrm/Om. This is required so that the tape will 
not rewind between files. Also notice that tapefile may be very large, 
and that there must be enough room in the file system to hold it 
before this will work. It is also possible to use logical disk drives 
(e.g., /dev/dsk/0s5), but this can be extremely dangerous if used 
incorrectly. Note that a cartridge tape will operate in streaming mode 
only if a raw logical disk is specified. 
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NOTES 
This command is a Plexus feature; it is not part of standard Sysd. 


BUGS 
The —v option doesn’t work for streaming cartridge tape drives. ee 
The —p option doesn’t work for Plexus P/15 or P/20 systems. 
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cp, In, mv — copy, link or move files 


SYNOPSIS 


cp file1 { file2 ...] target 
in [ —f ] file1 [ file2 ...] target 
mv [ —f ] filei [ file2 ...] target 


DESCRIPTION 


Filel is copied (linked, moved) to target . Under no circumstance can 
file! and target be the same (take care when using sh (1) metachar- 
acters). If target is a directory, then one or more files are copied 
(linked, moved) to that directory. If target is a file, its contents are 
destroyed. 


lf mv or /n determines that the mode of target forbids writing, it will 
print the mode (see chmod (2)), ask for a response, and read the 
standard input for one line; if the line begins with y , the mv or In 
occurs, if permissable; if not, the command exits. No questions are 
asked and the mv or In is done when the -—f option is used or if the 
standard input is not a terminal. 


Only mv will allow filet to be a directory, in which case the directory 
rename will occur only if the two directories have the same parent; 
file! is renamed target. If file? is a file and target is a link to another 
file with links, the other links remain and target becomes a new file. 


When using cp , if target is not a file, a new file is created which has 
the same mode as file? except that the sticky bit is not set unless you 
are super-user; the owner and group of target are those of the user. 
lf target is a file, copying a file into target does not change its mode, 
owner, nor group. The last modification time of target (and last 
access time, if target did not exist) and the last access time of file7 
are set to the time the copy was made. If target is a link to a file, all 
links remain and the file is changed. | 


SEE ALSO 


BUGS 
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cpio(1), rm(1). 
chmod(2) in the Sys5 UNIX Programmer Reference Manual. 


lf file! and target lie on different file systems, mv must copy the file 
and delete the original. In this case any linking relationship with 
other files is lost. 


Ln will not link across file systems. 
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NAME oe 
cpio — copy file archives in and out 


SYNOPSIS | See 
cpio —o [ acBv ] [ size [ b[k|m ] ] 


cpio —i [ BcdmrtuvfsSb6 ] [ patterns ] 
cpio —p [ adimruv | directory 


DESCRIPTION 

Cpio —o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. Output is padded to a 512-byte 
boundary. The size specifies the maximum number of bytes each 
output volume holds. The b option multiplies the size by 512. The k 
option multiplies the size by 1024. The m option multiplies the size 
by 1024 * 1024 (1Mb). 


Cpio —i (copy in) extracts files from the standard input, which is 
assumed to be the product of a previous cpio —o . Only files with 
names that match patterns are selected. Patterns are given in the 
name-generating notation of sh (17). In patterns , meta-characters ? , + 
, and [ ... ] match the slash / character. Multiple patterns may be 
specified and if no patterns are specified, the default for patterns is + 
(i.e., select all files). The extracted files are conditionally created and 
copied into the current directory tree based upon the options 
described below. The permissions of the files will be those of the 
previous cpio —o . The owner and group of the files willbe that ofthe | / 
Current user unless the user iS Super-user, which causes cpio to 

retain the owner and group of the files of the previous cpio —o. 


Cpio —p (pass) reads the standard input to obtain a list of path 
names of files that are conditionally created and copied into the des- 
tination directory tree based upon the options described below. 


The meanings of the available options are: 


a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does 
not apply to the pass option; meaningful only with data 
directed to or from tape devices). 


d Directories are to be created as needed. 

c Write header information in ASCII character form for portabil- 
ity. 

r Interactively rename files. If the user types a null line, the file 
is skipped. 

t Print a table of contents of the input. No files are created. 


Copy unconditionally (normally, an older file will not replace a 
newer file with the same name). 


Vv Verbose : causes a list of file names to be printed. When used 

with the t option, the table of contents looks like the output of 

an is —I command (see /s (1)). _ 
Whenever possible, link files rather than copying them. \ 

Usable only with the —p option. | = 
m Retain previous file modification time. This option is 


ineffective on directories that are being copied. 
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f -Copy in all files except those in patterns. 

co S Swap bytes. Use only with the —i option. 

( S Swap halfwords. Use only with the —i option. 
- b Swap both bytes and halfwords. Use only with the —i option. 
EXAMPLES 
The first example below copies the contents of a directory onto a 
tape in cpio archive format; the second duplicates a directory hierar- 
chy: : 
Is | cpio -o >/dev/rrm/Om 


cd olddir 
find . —-depth —print | cpio —pdl newdir 


The trivial case ‘“‘find . -—depth —print | cpio -oB >/dev/rrm/O0m’”’ can 
be handled more efficiently by: 


find . -cpio /dev/rrm/Om 


SEE ALSO 
ar(1), find(1), Is(1). 
cpio(4) in the Sys5 UNIX Programmer Reference Manual. 


BUGS 
Path names are restricted to 128 characters. If there are too many 
unique linked files, the program runs out of memory to keep track of 
them and, thereafter, linking information is lost. Only the super-user 
can copy special files. The —B option does not work with certain 
er magnetic tape drives (see un32 (7) in the “Sys5 UNIX Administrator 
( Reference Manual" ). | 
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NAME 


cpp — the C language preprocessor 


SYNOPSIS 


/lib/cpp [ option ... ] [ ifile [ ofile ] J 


DESCRIPTION 


Page 1 


Cpp is the C language preprocessor which is invoked as the first 
pass of any C compilation using the cc (1) command. Thus the out- 
put of cpp is designed to be in a form acceptable as input to the 
next pass of the C compiler. As the C language evolves, cpp and the 
rest of the C compilation package will be modified to follow these 
changes. Therefore, the use of cpp other than in this framework is 
not suggested. The preferred way to invoke cpp is through the cc (1) 
command, since the functionality of cpp may someday be moved 
elsewhere. See m4 (1) for a general macro processor. 


Cpp optionally accepts two file names as arguments. /file and ofile 
are respectively the input and output for the preprocessor. They 
default to standard input and standard output if not Supplied. 


The following options to cpp are recognized: 


—P Preprocess the input without producing the line control infor- 


mation used by the next pass of the C compiler. 


—C By default, cpp strips C-style comments. If the —C option is 
specified, all comments (except those found on cpp directive 
lines) are passed along. 


—Uname 
Remove any initial definition of name , where name is a 
reserved symbol that is predefined by the particular prepro- 
cessor. 7 


—Dname 

—Dname=def 
Define name as if by a #define directive. If no =def is given, 
name is defined as 1. The —D option has lower precedence 
than the —U option. That is, if the same name is used in both 
a —U option and a —D option, the name will be undefined 
regardless of the order of the options. 


—T Except on the PDP-11, preprocessor symbols are no longer 
restricted to eight characters. The —T option forces cpp to 
use only the first eight characters for distinguishing different 
preprocessor names. This behavior is the same as previous 
preprocessors with respect to the length of names and is 
included for backward compatability. 
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-Idir Change the algorithm for searching for #include files 
whose names do not begin with / to look in dir before look- 
ing in the directories on the standard list. Thus, #include 
files whose names are enclosed in "" will be searched for 
first in the directory of the file with the #include line, then in 
directories named in -I options, and last in directories on a 
Standard list. For #include files whose names are 
enclosed in <> , the directory of the file with the #include 
line is not searched. 


Two special names are understood by cop . The name __LINE__ is 
defined as the current line number (as a decimal integer) as known 
by cpp , and __FILE__ is defined as the current file name (as a C 
string) as known by cpp. They can be used anywhere (including in 
macros) just as any other defined name. 


All cpp directives start with lines begun by # . Any number of 
blanks and tabs are allowed between the # and the directive. The 
directives are: 


#define name token-string 
Replace subsequent instances of name with token-string . 


#define name( arg, ..., arg ) token-string 

Notice that there can be no space between name and the (. 
Replace subsequent instances of name followed by a(, a 
list of comma-separated set of tokens, and a ) by token- 
String , where each occurrence of an arg in the token-string 
is replaced by the corresponding set of tokens in the 
comma-separated list. When a macro with arguments is 
expanded, the arguments are placed into the expanded 
token-string unchanged. After the entire token-string has 
been expanded, cpp re-starts its scan for names to expand 
at the beginning of newly created token-string . 


#undef name 
Cause the definition of name (if any) to be forgotten from 
now on. 


#include "filename" 

#include <filename > 
Include at this point the contents of filename (which will then 
be run through cpp ). When the <filename> notation is 
used, filename is only searched for in the standard places. 
See the -I option above for more detail. 


#\ine integer-constant "filename" 
Causes cpp to generate line control information for the next 
pass of the C compiler. /nteger-constant is the line number 
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of the next line and filename is the file where it comes from. 
lf “filename” is not given, the current file name _ is 
unchanged. 

#endif : 
Ends a section of lines begun by a test directive (#if, 
#ifdef , or #ifndef ). Each test directive must have a 
matching #endif . 

#ifdef name 


The lines following will appear in the output if and only if 
name has been the subject of a previous #define without 
being the subject of an intervening #undef . 


#ifndef name 


The lines following will not appear in the output if and only if 
name has been the subject of a previous #define without 
being the subject of an intervening #undef . 


#if constant-expression 


#else 


Lines following will appear in the output if and only if the 
constant-expression evaluates to non-zero. All binary non- 
assignment C operators, the ?: operator, the unary — ,!, 
and ~ operators are all legal in constant-expression . The 
precedence of the operators is the same as defined by the 
C language. There is also a unary operator defined , which 
can be used in constant-expression in these two forms: 
defined ( name ) or defined name. This allows the utility 
of #ifdef and #ifndef in a #if directive. Only these 
operators, integer constants, and names which are known 
by cpp should be used in constant-expression . In particu- 
lar, the sizeof operator is not available. 


Reverses the notion of the test directive which matches this 
directive. So if lines previous to this directive are ignored, 
the following lines will appear in the output. And vice versa. 


The test directives and the possible #else directives can be nested. 


FILES 


‘usr/include standard directory for #include files 


SEE ALSO 


cc(1), m4(1). 


DIAGNOSTICS 


The error messages produced by cpp are intended to be self- 
explanatory. The line number and filename where the error 
occurred are printed along with the diagnostic. 
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| When new-line characters were found in argument lists for macros 
ae to be expanded, previous versions of cpp put out the new-lines as 
they were found and expanded. The current version of cpp 
replaces these new-lines with blanks to alleviate problems that the 
previous versions had when this occurred. 


( NOTES 


aes chal 
f \ 
7 ow 
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NAME 


crontab - user crontab file 


SYNOPSIS 


crontab [file] 
crontab -r 
crontab -l 


DESCRIPTION 
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Crontab copies the specified file, or standard input if no file is speci- 
fied, into a directory that holds all users’ crontabs. The -r option 
removes a user's crontab from the crontab directory. Crontab —| will 
list the crontab file for the invoking user. 


A user is permitted to use crontab if their name appears in the file 
/usr/lib/cron/cron.allow. lf that file does not exist, the file 
/usr/lib/cron/cron.deny is checked to determine if the user should 
be denied access to crontab. If neither file exists, only root is 
allowed to submit a job. If either file is at.deny, global usage is per- 
mitted. The allow/deny files consist of one user name per line. 


A crontab file consists of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the following: 


minute (0-59), 

hour (O—23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0 = Sunday). 


Each of these patterns may be either an asterisk (meaning all legal 
values), or a list of elements separated by commas. An element is 
either a number, or two numbers separated by a minus sign (mean- 
ing an inclusive range). Note that the specification of days may be 


made by two fields (day of the month and day of the week). If both 


are specified as a list of elements, both are adhered to. For exam- 
ple, 0 0 1,15 * 1 would run a command on the first and fifteenth of 
each month, as well as on every Monday. To specify days by only 
one field, the other field should be set to * (for example, 0 O * * 1 
would run a command only on Mondays). 


The sixth field of a line in a crontab file is a string that is executed 
by the shell at the specified times. A percent character in this field 
(unless escaped by \) is translated to a new-line character. Only the 
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first line (up to a % or end of line) of the command field is executed 
by the shell. The other lines are made available to the command as 
standard input. 


The shell is invoked from your $HOME directory with an argO of 
sh. Users who desire to have their .profile executed must explicitly 
do so in the crontab file. Cron supplies a default environment for 
every shell, defining HOME , LOGNAME , SHELL(=/bin/sh) , and 
PATH( = :/bin:/usr/bin:/usr/Ibin) . 


NOTE : Users should remember to redirect the standard output and 
standard error of their commands! If this is not done, any generated 
Output or errors will be mailed to the user. 


FILES 
/usr/lib/cron main cron directory 
/ust/spool/cron/crontabs spool area 
/usr/lib/cron/log accounting information 
/usr/lib/cron/cron.allow list of allowed users 
/ust/lib/cron/cron.deny list of denied users 
SEE ALSO 


sh(1). 
cron(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 
crypt — encode/decode 


SYNOPSIS 
crypt [ password | 


DESCRIPTION 
Crypt reads from the standard input and writes on the standard out- 
put. The password is a key that selects a particular transformation. 
If nO password is given, crypt demands a key from the terminal 
and turns off printing while the key is being typed in. Crypt encrypts 
and decrypts with the same key: 


crypt key <clear >cypher 
crypt key <cypher | pr 
will print the clear. 


Files encrypted by crypt are compatible with those treated by the 
editor ed in encryption mode. 


The security of encrypted files depends on three factors: the funda- 
mental method must be hard to solve; direct search of the key 
space must be infeasible; “sneak paths” by which keys or clear text 
can become visible must be minimized. 


Crypt implements a one-rotor machine designed along the lines of 
the German Enigma, but with a 256-element rotor. Methods of 
attack on such machines are known, but not widely; moreover the 
amount of work required is likely to be large. 


The transformation of a key into the internal settings of the machine 
is deliberately designed to be expensive, i.e., to take a substantial 
fraction of a second to compute. However, if keys are restricted to 
(say) three lower-case letters, then encrypted files can be read by 
expending only a substantial fraction of five minutes of machine 
time. 


Since the key is an argument to the crypt command, it is potentially 
visible to users executing ps (1) or a derivative. The choice of keys 
and key security are the most vulnerable aspect of crypt. 


FILES 

/dev/tty for typed key 
SEE ALSO 

ed(1), makekey(1), stty(1). 
BUGS 


If output is piped to nroff and the encryption key is not given on the 
command line, crypt can leave terminal modes in a strange state 
(see stty (1)). 
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If two or more files encrypted with the same key are concatenated 


and an attempt is made to decrypt the result, only the contents of 
the first of the original files will be decrypted correctly. 
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NAME 7 

csh — a shell (command interpreter) with C-like syntax 
SYNOPSIS 

/usr/pix/csh [ —cefinstvVxX ] [ arg... ] 
DESCRIPTION 


Csh is a command language interpreter. When you invoke tt, it first 
executes commands from the file .cshre in your home directory. If 
you are logging in, it also executes commands from the file .login 
there. Normally the shell then begins reading commands from the 
terminal, prompting with % (a per cent sign followed by a blank). 
Later in this manual entry, we will describe how the shell processes 
arguments and command scripts. 


The shell repeatedly reads a line of command input and breaks the 
line into words; piaces the sequence of words on the command his- 
tory list and parses it; and finally executes each command in the 
Current line. 


When a login C-shell terminates, it executes commands from the file 
-logout in your home directory. 


Lexical Structure 


The shell usually splits input lines into words at blanks and tabs. 
The characters &, | ;, <, >, (, and ) are exceptions, however; they 
all form separate words. If doubled, as in &&, || <<, or >>, these 
pairs form single words. These parser metacharacters may be 
made part of other words; their special meaning may be turned off 
by preceding them with \. A newline preceded by a \ is equivalent 
to a blank. 


In addition, strings enclosed in matched pairs of quotations, *, °, or”, 
form parts of a word; metacharacters in these strings, including 
blanks and tabs, do not form separate words. The semantics of 
these quotations are described below. Within pairs of \ or “ charac- 
ters, a newline preceded by a \ gives a true newline character. 


When the shell’s input is not a terminal, the character # introduces 
a comment, which continues to the end of the input line. It is 
prevented this special meaning when preceded by \ and in quota- 
tions using ~, °, and ”. 

Commands 


A simple command is a sequence of words, the first of which speci- 
fies the command to be executed. A simple command or a 
sequence of simple commands separated by | characters forms a 
pipeline. In a pipeline, the output of each command becomes the 
input of the next. A command line may contain sequences of pipe- 
lines; separate the pipelines by ;, and they are then executed 
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sequentially. You do not necessarily have to wait for a sequence of 
pipelines to finish executing before you issue another command: by 
following the command with an ampersand (&), the sequence of 
pipelines (0 or more) is executed in background mode, and you 
receive another shell prompt immediately. A command sequence 
followed by an ampersand is not terminated by a hangup signal; the 
nohup command need not be used. 


Commands or pipelines may be placed in parentheses ( ) to form 
another simple command (which may be a component of a pipeline, 
etc.) You may also separate pipelines with || or && indicating, as in 
the C language, that the second component is to be executed only if 
the first fails or succeeds respectively. (See Expressions. ) 


Substitutions 
The shell performs various transformations on its input. 
History Substitutions 


History substitutions reintroduce sequences of words from previous 
commands. They may also perform modifications on these words. 
Thus history substitutions provide a generalization of a redo func- 
tion. 


History substitutions begin with the character ! and may begin any- 
where in the input stream if a history substitution is not already in 
progress. This / may be preceded by an \ to prevent its special 
meaning; a ! is passed unchanged when it is followed by a blank, 
tab, newline, = or (. History substitutions also occur when an input 
line begins with t. This special abbreviation is described later. 


Input lines containing history substitution metacharacters are 
echoed on the terminal before being executed. The echoed version 
shows the command line as it could have been typed without history 
substitution. 


The history mechanism saves some number of commands input 
from the terminal. The size of the history list thus created is con- 
trolled by the history variable. The immediately previous command 
is always retained. Commands are numbered sequentially from 1. 


For example,, consider the following output from the history com- 
mand: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff «write.c 


The commands are shown with their event numbers. You dont 
always need to use event numbers when you use the history 
mechanism; if you want to see them for each command, the current 
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event number can be made part of the prompt by placing an ! in the 
prompt string. 


If the current event is number 13, you can refer to event 11 by its 
event number as in !11; by its event number relative to the current 
event number as in !—2; by a prefix of a command word as in !c; or 
by a string contained in a word in the command as in !?old?. 
These forms, without further modification, simply repeat the com- 
mand line of event 11. As a special case !! refers to the previous 
command; thus !! alone is essentially a redo. The form !# refers to 
the current command (the one being typed in). See below for an 
example of this in use. 


To select words from a previous command line, use a colon (:) and 
a designator for the desired words. The words of a input line are 
numbered from 0, the first (usually command) word being 0, the 
second word (first argument) being 1, etc. The basic word designa- 
tors are: 


0 first (command) word 
n n'th argument 

t first argument, i.e. “1” 
$ last argument 


% word matched by (immediately preceding) ?s ? search 


x-y — range of words 
—y abbreviates “O—-y” 


* abbreviates “1—$", or nothing if only 1 word in event 
X * abbreviates “x —$” 
x— like “x *” but omitting word “$” 


Thus the command 
diff /usr/man/docs/vpm1.0 /usr/man/docs/vpm2.0 ; vi !#:1 


uses both the “!#” convention for the current command line, and the 
“in convention for argument number. The effect of this command 
is to display the differences between the two files on the standard 
output, and then summon the editor vi for use on the first file (argu- 
ment number 1). 


The : separating the event specification from the word designator 
can be omitted if the argument selector begins with a 1, $, *, —, or 
%. SO, in the example above, the vi portion could have been 
equivalently typed 


vi !#° 


A sequence of modifiers can be placed after the optional word 
designator. Each modifier is preceded by a :. The following modif- 
lers are defined: 
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h Remove a trailing pathname component, leaving the head. 
r Remove a trailing .xxx component, leaving the root name. 
s/l/r/_ Substitute / for r 

Remove all leading pathname components, leaving the tail. 
& Repeat the previous substitution. 
g Apply the change globally, prefixing the above, e.g. g&. 
p Print the new command but do not execute it. 
q Quote the substituted words, preventing further substitutions. 
x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a g the modification is applied only to the first 
modifiable word. It is always an error for no word to be applicable. 


Expressions on the left hand side of substitutions are not regular 
expressions in the sense of the editors; rather, they are strings. 
Any character may be used as the delimiter in place of /; a \ quotes 
the deiimiter. The character & in the right hand side is replaced by 
the text from the left. A \ quotes & also. A null / (left hand side 
expression) uses the previous string either from a / or from a con- 
textual scan string s in !?s?. The trailing delimiter in the substitu- 
tion may be omitted if a newline follows immediately; the same goes 
for the trailing ? in a contextual scan. 


You can use a history reference without an event specification, e.g. 
1$. In this case the reference is to the previous command unless a 
previous history reference occurred on the same line in which case 
this form repeats the previous reference. Thus !?foo?t !$ gives the 
first and last arguments from the command matching ?f00o7?. 


A special abbreviation of a history reference occurs when the first 
non-blank character of an input line is a t. This is equivalent to !:st, 
providing a convenient shorthand for substitutions on the text of the 
previous line. Thus tlbtlib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be surrounded with { 
and } to insulate it from the characters that follow. Thus, after Is 
“sandy we might do {{I}1 to get Is “sandy1, while !11 would look for 
a command starting I1. 


Quotations with ’ and " 


The quotation of strings by ’ and " can prevent all or some substitu- 
tions. Strings enclosed in ’ are prevented any further interpretation. 
Strings enclosed in “ are variable and command expanded as 
described below. | 


In both cases the resulting text becomes (all or part of) a single 
word; only in one special case (see Command Substitition below) 
does a “ quoted string yield parts of more than one word; ’ quoted 
strings never do. 
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Alias Substitution 


The shell maintains a list of aliases that can be established, 
displayed and modified by the alias and unalias commands. After 
scanning a command line, the C shell parses it into distinct com- 
mands and checks the first word of each command, left-to-right, to 
see if it has an alias. If it does, then the text that is the alias for that 
command is reread as though that command were the previous 
input line. The history mechanism remains fully operational within 
aliasing. The resulting words replace the command and argument 
list. 


Thus if the alias for Is is Is -I, the command Is /usr becomes Is -| 
/usr. The argument list here is undisturbed. Similarly if the alias for 
lookup is grep !t /etc/passwd, then lookup bill becomes grep bill 
/etc/passwd. 


If the C shell finds an alias, it transforms the words of the input text 
and begins the aliasing process again on the reformed input line. If 
the first word of the new text is the same as the old, the shell flags it 
to prevent further aliasing. Other loops are detected and cause an 
error. | 


Note that the mechanism allows aliases to introduce parser 
metasyntax. Thus we can alias print \fipr \!* | Ipr\f1 to make a 
command that prs its arguments to the line printer. 


Variable Substitution 


The shell maintains a set of variables, each of which has as value a 
list of zero or more words. Some of these variables are set by the 
shell or referred to by it. For instance, the argv variable is an image 
of the shell’s argument list, and words of this variable’s value are 
referred to in special ways. For a complete list of the shell’s pre- 
defined variables, see the section Pre-defined Variables towards the 
end of this manual entry. ~ 


The values of variables may be displayed and changed by using the 
set and unset commands. A number of the variables referred to by 
the shell are toggles; the shell does not care what their value is, 
only whether they are set or not. For instance, the verbose variable 

— is a toggle that causes command input to be echoed. The setting of 
this variable results from the —v command line option. 


Other operations treat variables numerically. The @ command per- 
mits numeric calculations to be performed and the result assigned to 
a variable. Variable values are, however, always represented as 
(zero or more) strings. For the purposes of numeric operations, the 
null string is considered to be zero, and the second and subsequent 
words of multiword values are ignored. 
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—— After alaising and parsing the input line, and before executing each 
( command, the shell performs variable substitution, keyed by $ char- 

acters. This expansion can be prevented by preceding the $ with a 
\, except within always occurs, and within ‘fRs where it never 
occurs. Strings quoted by ~ are interpreted later (see Command 
Substitution below) so $ substitution does not occur there until later, 
if at all. A $ is passed unchanged if followed by a blank, tab, or 
end-of-line. 


Input/output redirections are recognized before variable expansion, 
and are variable-expanded separately. With no I/O redirection, the 
command name and entire argument list are expanded together. 
Thus the first (Command) word may generate more than one word, 
the first of which becomes the command name, and the rest of 
which become arguments. 


Unless enclosed in “ or given the :q modifier, the results of variable 
substitution may eventually be command and filename substituted. 
Within ”, a variable whose value consists of multiple words expands 
to a (portion of) a single word, with the words of the variable’s value 
separated by blanks. When the :q modifier is applied to a substitu- 
tion, the variable expands to multiple words, with each word 
7 separated by a blank and quoted to prevent later command or 
( filename substitution. 


= The following metasequences are provided for introducing variable 
values into the shell input. Except as noted, it is an error to refer to 
a variable that is not set. 


$name 
${name} 


Are replaced by the words of the value of variable name, 
each separated by a blank. Braces insulate name from fol- 
lowing characters that would otherwise be part of it. Shell 
variables have names consisting of up to 20 letters, digits, 
and underscores. 


If name is not a shell variable, but is set in the environment, 
then that value is returned (but : modifiers and the other 
forms given below are not available in this case). 


$name[selector] 
${name{[selector]} 


May be used to select only some of the words from the 
_ value of name. The selector is subjected to $ substitution 
( and may consist of a single number or two numbers 

separated by a -. The first word of a variable’s value is 
numbered 1. If the first number of a range is omitted, it 
defaults to 1. If the last member of a range is omitted, it 
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defaults to $#name. The selector * selects all words. It is 


not an error for a range to be empty if the second argument ~~ 
is omitted or in range. 7 
$#name 
${#name} 


Gives the number of words in the variable. This is useful for 
later use in a [selector]. 

$0 
Substitutes the name of the file from which command input 
is being read. An error occurs if the name is not known. 


$number 
${number} 


Equivalent to $argv[number]. 
$x 

Equivalent to $argv/*/]. 
The modifiers :h, :t, :r, :q and :x may be applied to the substitutions 
above as may :gh, :gt and :gr. If braces { } appear in the com- 
mand form, the modifiers must appear within the braces. The 


current implementation allows only one : modifier on each $ expan- 
sion. 


The following substitutions may not be modified with : modifiers. 


$?name 
${?name} 


Substitutes the string “1” if name is set, “O” if it is not. 

$70 
Substitutes “1” if the current input filename is known, “O” if 
it is not. 


$$ 


Substitute the (decimal) process number of the (parent) 
shell. 


Command and Filename Substitution 


Command and filename substitutions are applied selectively to the 
arguments of built-in commands. This means that portions of 
expressions that are not evaluated are not subjected to these 
expansions. For commands not internal to the shell, the command 
name is substituted separately from the argument list. This occurs aa 
very late, after input-output redirection is performed, and in achild 
of the main shell. 
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Command Substitution 


“ 


Enclosing a command in ~ indicates command substitution. The 
shell breaks the output from such a command into separate words 
at blanks, tabs and newlines; it discards null words. It then replaces 
the original string with this text. Within "s, only newlines force new 
words; blanks and tabs are preserved. 


In any case, the single final newline does not force a new word. 
Thus a command substitution may yield only part of a word, even if 
the command outputs a complete line. 


Filename Substitution 


If a word contains any of the characters +, ?, [ or { or begins with 
the character ~, then that word is a candidate for filename substitu- 
tion, also Known as globbing. This word is then regarded as a pat- 
tern, and replaced with an alphabetically sorted list of file names 
that match the pattern. If several words on the same command line 
specify filename substitution, the C shell returns an error only if no 
pattern matches an existing file name. It does not return an error if 
some matches are successful and others are not. Only the meta- 
characters +, ? and [ imply pattern matching; the characters ~ and { 
being more akin to abbreviations. 


In matching filenames, the character . at the beginning of a filename 
or immediately following a /, as well as the character /, must be 
matched explicitly. The character * matches any string of charac- 
ters, including the null string. The character ? matches any single 
character. The sequence [...] matches any one of the characters 
enclosed. Within [...], a pair of characters separated by — matches 
any character lexically between the two. 


The character ~ at the beginning of a filename refers to home direc- 
tories. Standing alone, i.e. ~, it expands to the invoker’s home direc- 
tory as reflected in the value of the variable home. When followed 
by a name consisting of letters, digits and — characters the shell 
searches for a user with that name and substitutes his home direc- 
tory; thus “ken might expand to /usr/ken and “ken/chmach to 
/usr/ken/chmach. If the character ~ is followed by a character other 
than a letter or / or appears someplace other than at the beginning 
of a word, it is left undisturbed. 


The metanotation a{b,c,d}e is a shorthand for abe ace ade. The 
shell preserves left to right order, and sorts the results of matches 
separately at a low level to preserve this order. This construct may 
be nested. Thus, ‘“source/si/{oldis,!s}.c expands to 
/usr/source/st/oldis.c /usr/source/s1/Is.c. This works whether or 
not these files exist. There is no chance of error if the home direc- 
tory for source is /usr/source. Similarly ..{memo,*box} might 
expand to ../memo ../box ../mbox. (Note that memo is not sorted 
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with the results of matching *box.) As a special case {, } and {} are 
passed undisturbed. 


Input/Output 


The standard input and standard output of a command may be 
redirected with the following syntax: 


< name 


Open file name (which is first variable, command and 
filename expanded) as the standard input. 


<< word 


Read the shell input up to a line identical to word. The shell 
does not perform variable, filename or command substitu- 
tion on word. It compares each input line to word before 
doing any substitutions on this input line. Unless a quoting 
\, ", ° or ~ appears in word, the shell performs variable and 
command substitution on the intervening lines, allowing \ to 
quote $, \ and ~. Commands that are substituted have all 
blanks, tabs, and newlines preserved, except for the final 
newline, which is dropped. The shell places the resultant 
text in an anonymous temporary file, which it then gives to 
the command as standard input. 


> name 
>! name 
>& name 
>&! name 


The file name is used as standard output. If the file does 
not exist, it is created; if the file exists, its previous contents 
are lost. 


The variable noclobber is designed to prevent accidental 
overwriting of files by ">". If the variable noclobber is set, 
then the file named by name must either not exist or be a 
character special file (e.g. a terminal or /dev/nulf); other- 
wise, noclobber prevents the redirection and issues an error 
message. The ! forms suppress this check. 


The forms involving & route the diagnostic output into the 
specified file as well as the standard output. Name is 
expanded in the same way as < input filenames are. 


>> name 
>>& name 
>>! name 
>>&!l name 


Uses file name as standard output like > but places output 
at the end of the file. If the variable noclobber is set, then it 
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is an error for the file not to exist unless one of the ! forms 
is given. Otherwise similar to >. 


If a simple command is run in foreground mode, without being fol- 
lowed by &, its environment is that of the shell that runs it. If a shell 
procedure is run in foreground mode, without being followed by &, 
each command within the procedure receives the environment in 
which the procedure was invoked. In other words, the shell spawned 
by the shell procedure inherits the environment of the shell that 
spawned it. This environment may be modified by command-line 
factors such as input-output parameters or the presence of the com- 
mand in a pipeline. Thus commands run from within a shell pro- 
cedure receive the standard input of the shell that is running the 
script; commands within a shell script know nothing about each 
other. Since we often want a command within a shell script to 
receive standard input not from the shell that runs the script but 
from within the script itself, we need a way to present such inline 
data. The << mechanism serves this function. It permits shell 
command scripts to function as components of pipelines and allows 
the shell to block read its input. See An Introduction to the C Shell 
for examples of the use of the << mechanism. 


If a command or shell procedure is run detached (followed by &), its 
default standard input is the empty file /dev/null. 


Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form |& rather than just | 


Expressions 


A number of the shell’s built-in commands (described in the section 
“Built-in Commands” below) take expressions, in which the opera- 
tors are similar to those of C, with the same precedence. Built-in 
commands that take expressions include @, exit, if, and while. The 
following operators are available for use within expressions: 


| && lt & == l= <= >= < > 
<< >> +-—-* /%!7~ () 


In this list the precedence increases to the right, and down, == and 
I=, <= >= < and >, << and >>, + and-, * / and % being, in 
groups, at the same level. The == and != operators compare their 
arguments as strings; all others operate on numbers. Strings that 
begin with 0 are considered octal numbers. The shell evaluates null 
or missing arguments as O. The results of all expressions are 
strings, which represent decimal numbers. Components of expres- 
sions should be surrounded by spaces; this always matters, except 
when components are adjacent to & | <, >, (, or), which are syn- 
tactically significant to the parser. 
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Command executions enclosed in { and } and file enquiries are also 
available in expressions as primitive operands. File enquiries take 
the form “— 1 name”, where / is one of: 


read access 
write access 
execute access 
existence 
ownership 

zero size 

plain file 
directory 


Qa7*NOOxs 7 


“Name” is command and filename expanded and then tested to see 
if it has the specified relationship to the real user. If the file does 
not exist or is inaccessible, all enquiries return false, i.e., 0. 


Command executions succeed, returning true, i.e., 1, if the com- 
mand exits with status 0; otherwise they fail, returning false, i.e. 0. 
lf you want more detailed status information about a command, exe- 
cute the command outside of an expression and examine the vari- 
able stafus. | 


Control Flow 


The shell contains commands that can regulate the flow of control in 
command files (shell scripts) and (in limited but useful ways) from 
-terminal input. These commands all operate by forcing the shell to 
reread or skip in its input. Due to the implementation, the shell res- 
tricts the placement of some of the commands. 


The foreach, switch, and while statements, as well as the 
if-then-else form of the /f statement require that the major key- 
words appear in a single simple command on an input line as shown 
below. 


If the shell’s input is not seekable, the shell buffers up input when- 
ever a loop is being read and performs seeks in this internal buffer 
to accomplish the rereading implied by the loop. (To the extent that 
this allows, backward goto’s succeed on non-seekable inputs.) 


Built-in Commands 


Built-in commands are executed within the shell. If a built-in com- 
mand occurs as any component of a pipeline except the last, it is 
executed in a subshell. 


alias 
alias name 
alias name wordlist 


The first form prints all aliases. The second form prints the 
alias for “name’. The final form assigns the specified 
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a wordlist as the alias of name; wordlist is command and 
( | filename substituted. Name may not be alias or unalias 


break 


Causes execution to resume after the end of the nearest 
enclosing forall or while. The remaining commands on the 
current line are executed. Multi-level breaks are thus possi- 
ble by writing them all on one line. 


breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 


cd 

cd name 
chdir 

chdir name 


Change the shell’s working directory to directory name. If no 
argument is given then change to the home directory of the 
user. 


tory (and does not begin with /, ./, or ..4), each component of 
the variable cdpath is checked to see if it has a subdirec- 
tory name. Finally, if all else fails but name is a shell vari- 
able whose value begins with /, then this is tried to see if it 
is a directory. 


( If name is not found as a subdirectory of the current direc- 


continue 


Continue execution of the nearest enclosing while or 
foreach. The rest of the commands on the current line are 
executed. 


default: 


Labels the default case in a switch statement. The eoaut 
should come after all case labels. 


echo wordlist 


The specified words are written to the shell’s standard out- 
put. A \c causes the echo to complete without printing a 
newline, akin to the \c in nroff(1). A \n in wordlist causes a 
newline to be printed. 


ma else 
( 7 end 
_ endif 
endsw 
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See the description of the foreach, if, switch, and while 
statements below. 


exec command 


exit 


The specified command is executed in place of the current 
shell. 


exit(expr) 


The shell exits either with the value of the status variable 
(first form) or with the value of the specified expr (second 
form). 


foreach name (wordiist) 


end 


The variable name is successively set to each member of 
wordlist and the sequence of commands between this com- 
mand and the matching end are executed. (Both foreach 
and end must appear alone on separate lines.) 


The built-in command continue continues the loop prema- 
turely and the built-in command break terminates it prema- 
turely. When the C shell reads a foreach command from 
the terminal, it reads the loop once and prompts with ? 
before executing any statements in the loop. If you make a 
mistake typing in a loop at the terminal, you can rub it out. 


glob wordlist 


Like echo but no \ escapes are recognized and words are 
delimited by null characters in the output. Useful for pro- 
grams that use the shell to filename expand a list of words. 


goto word 


history 


The specified word is filename and command expanded to 
yield a string of the form /abe/. The shell rewinds its input 
as much as possible and searches for a line of the form 
label:, possibly preceded by blanks or tabs. Execution con- 
tinues after the /abel line. 


Displays the history event list. 


if (expr) command 
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If the specified expression evaluates true, then the single 
command with arguments is executed. Variable substitution 
on command happens early, at the same time as for the 
rest of the if command. Command must be a simple 
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command--not a_ pipeline, a command list, or a 
parenthesized command list. Input/output redirection occurs 
even if expr is false, when command is not executed (this is 
a bug). 


if (expr) then 


else if (expr2) then 


else 


endif 


login 


logout 


nice 


If the specified expr is true then all the commands up to the 
first else are executed; if expr2 is true then the commands 
to the second else are executed, etc. Any number of e/se-/f 
pairs are possible; only one endif is needed. The else part 
is likewise optional. (The words else and endif must appear 
at the beginning of input lines; the /f must appear alone on 
its input line or after an e/se. ) 


Terminate a login shell, replacing it with an instance of 
/bin/login. This is one way to log off, included for compati- 
bility with /bin/sh. 


Terminate a login shell. Especially useful if ignoreeof is set. 


nice +number 
nice command 
nice +number command 


nohup 


The first form sets the nice for this shell to 4. The second 
form sets the nice to the given number. The final two forms 
run command at priority 4 and number respectively. The 
Super-user may specify negative niceness by using nice 
—number .... Command is always executed in a sub-shell, 
and the restrictions on commands in simple if statements 


apply. 


nohup command 


Shell scripts use the first form to cause hangups to be 
ignored for the remainder of the script. The second form 
causes the specified command to be run with hangups 
ignored. Unless the shell is running detached, nohup has no 
effect. All processes detached with & are automatically 
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nohuped. (Thus, nohup is not really needed.) 


The SYSTEM Ill utility /bin/nohup is incompatible with the 
csh nohup. Therefore, to use the SYSTEM Ill command, 
you must invoke it with its full pathname. 


onintr | 
onintr — 
onintr label 


Control the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts (i.e., to 
terminate shell scripts or return to the terminal command 
input level). The second form onintr — causes all interrupts 
to be ignored. The final form causes the shell to execute a 
goto label when an interrupt is received or a child process 
terminates because it was interrupted. 


In any case, if the shell is running detached and interrupts 
are being ignored, all forms of onintr have no meaning and 
interrupts continue to be ignored by the shell and all invoked 
commands. 


rehash 


Causes the internal hash table of the contents of the direc- 
tories in the path variable to be recomputed. This is needed 
if new commands are added to directories in the path while 
you are logged in. This should only be necessary if you add 
commands to one of your own directories, or if a systems 
programmer changes the contents of one of the systern 
directories. 


repeat count command 


The specified command (which is subject to the same res- 
trictions as the command in the one-line if statement 
above), is executed count times. I/O redirection occurs 
exactly once, even if count is 0. 


set 

set name 

set name=word 

set name[index]=word 
set name = (wordlist) 


The first form of the command shows the value of all shell 
variables. Variables that have other than a single word as 
value print as a parenthesized word list. The second form 
sets name to the null string. The third form sets name to 
the single word. The fourth form sets the indexth com- 
ponent of name to word; this component must already exist. 
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yen. The final form sets name to the list of words in wordlist. In 
( | all cases the value is command and filename expanded. 


These arguments may be repeated to set multiple values in 
a single set command. Note however, that variable expan- 
sion happens for all arguments before any setting occurs. 


setenv name value 


(Version 7 systems only.) Sets the value of environment 
variable name to be value, a single string. Useful environ- 
ment variables are TERM, the type of your terminal, and 
SHELL, the shell you are using. 


shift 
shift variable 


The members of argv are shifted to the left, discarding 
argv[1]. It is an error for argv not to be set or to have less 
than one word as value. The second form performs the 
same function on the specified variable. 


source name 


The shell reads commands from name. Source commands 
may be nested; if they are nested too deeply the shell may 

( | run out of file descriptors. An error in a source at any level 
terminates all nested source commands. Input during 
source commands is never placed on the history list. 


switch (string) 
case str1: 


breaksw 
default: 


breaksw 
endsw 


Each case label is successively matched against the speci- 

fied string, which is first command and filename expanded. 

The file metacharacters +, ? and [...] may be used in the 

case labels, which are variable expanded. If none of the 

labels match before a default label is found, then the exe- 

cution begins after the default label. Each case label and 

the default label must appear at the beginning of a line. The 

command breaksw causes execution to continue after the 

fC endsw. Otherwise control may fall through case labels and 

( default labels as in C. If no label matches and there is no 
default, execution continues after the endsw. 
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time 
time command 


With no argument, the shell prints a summary of time used aa 
by this shell and its children. With arguments, the shell 
times the specified simple command and prints a time sum- 
mary as described under the time variable. If necessary, an 
extra shell is created to print the time statistic when the 
command completes. 


umask 
umask value 


The file creation mask ts displayed (first form) or set to the 
specified value (second form). The mask is given in octal. 
Common values for the mask are 002, giving all access to 
the group and read and execute access to others; or 022, 
giving all access except no write access for users in the 
group or others. 


unalias pattern 


The shell discards all aliases whose names match the 
specified pattern. Thus all aliases are removed by unalias 
*, It is not an error for nothing to be unaliased. 


unhash 


Use of the internal hash table to speed location of executed 
programs is disabled. 


unset pattern 


The shell removes all variables whose names match the 
specified pattern. Thus all variables are removed by unset 
*: this can have distasteful side-effects. It is not an error for 
nothing to be unset. 


wait 


The shell waits for all child processes. If the shell is interac- 
tive, then an interrupt can disrupt the wait, at which time the 
shell prints names and process numbers of all children 
known to be outstanding. 


while (expr) 


end 


While the specified expression evaluates non-zero, the com- 
mands between the while and the matching end are 
evaluated. Break and continue can terminate or continue 
the loop prematurely. (The while and end must appear a 
alone on their input lines.) If the input is from a terminal, 
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on prompting occurs here the first time through the loop as for 
( | the foreach statement. 


@ 
@ name = expr 
@ name[index] = expr 


The first form prints the values of all the shell variables. 
The second form sets the specified name to the value of 
expr. If the expression contains <, >, & or |, then at least 
this part of the expression must be placed within 
parentheses (). The third form assigns the value of expr to 
the indexth argument of name. Both name and its indexth 
component must already exist. 


The operators *=, +=, etc are available as in C. The 
space separating the name from the assignment operator is 
optional. Spaces are, however, mandatory in separating 
components of expr that would otherwise be single words. 


Special postfix ++ and — operators increment and decre- 
ment name respectively, i.e. @ i++. 


Pre-defined Variables 


The following variables have special meaning to the shell. Of these, 
the shell always sets argv, child, home, path, prompt, shell and 
Status. This setting occurs only at initialization, except for child and 
Status. Variables set by the shell are not subsequently modified by 
the shell, though the user may explicitly modify them. 


The shell copies the environment variable PATH into the variable 
path, and copies the value back into the environment whenever 
path is set. Thus you need not worry about its setting other than in 
the file .cshrc, because inferior csh processes import the definition 
of path from the environment. 


argv Set to the arguments to the shell, it is from this 
variable that positional parameters are substituted, 
i.e. $17 is replaced by $argv/1], etc. 


cdpath Specifies a list of alternate directories to be 
searched by chdir commands. 


child The process number printed when the last com- 
mand was forked with &. This variable is unset 
when this process terminates. 


echo Set when the —x command line option is given. 

ae Causes each command and its arguments to be 
( echoed just before it is executed. For non-built-in 
commands, all expansions occur before echoing. 
Builtin commands are echoed before command 
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histchars 


history 


home 


ignoreeof 


mail 


noclobber 


noglob 


nonomatch 
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and filename substitution, since these substitutions © 
are then done selectively. 


Can be assigned a two character string. The first 
character is used as a history character in place of 
!, the second character is used in place of the ° 
substitution mechanism. For example, set 
histchars=",;"" makes the history characters a 
comma and semicolon. 


Takes a numeric value that controls the size of the 
history list. The shell does not discard any com- 
mand referenced in this many events. Too large 
values of history may run the shell out of memory. 
The last executed command is always saved on 
the history list. 


The home directory of the invoker, initialized from 
the environment. The filename expansion of ~ 
refers to this variable. 


If set, the shell ignores end-of-file from input dev- 
ices that are terminals. This prevents shells from 
accidentally being killed by control-Ds. 


The files where the shell checks for mail. The shell 
checks for mail after each command completion 
that results in a prompt, if a specified interval has 
elapsed. If any of these files exists with an access 
time not greater than its modify time, the shell 


sends the message “You have new mail.” 


lf the first word of the value of mai/ is numeric it 
specifies a mail checking interval, in seconds, dif- 
ferent from the default, which is 10 minutes. 


If multiple mail files are specified, then the shell 
says New mail in name when there is mail in the 
file name. 


As described in the section on /nput/output, restric- 
tions are placed on output redirection to insure that 
files are not accidentally destroyed, and that >> 
redirections refer to existing files. 


If set, filename expansion is inhibited. This is most 
useful in shell scripts that do not deal with 
filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 


If set, it is not an error for a filename expansion to 
not match any existing files; rather the primitive 
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path 


prompt 


shell 


status 


time 


verbose 
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pattern is returned. It is still an error for the primi- 
tive pattern to be malformed, i.e. echo | still gives 
an error. 


Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If no 
path variable is specified, only full path names 
work. The usual search path is ., /bin and /usr/bin, 
but this may vary from system to system. For the 
super-user the default search path is /etc, /bin and 
/usr/bin. A shell that is given neither the —c nor the 
—t option will normally hash the contents of the 
directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new 
commands are added to these directories while the 
shell is active, it may be necessary to give the 
rehash or the commands may not be found. 


The string printed before each command is read 
from an interactive terminal input. If a / appears in 
the string it is replaced by the current event 
number unless a preceding \ is given. Default is % 
, or # for the super-user. 


The file in which the shell resides. This is used in 
forking shells to interpret files which have execute 
bits set, but which are not executable by the sys- 
tem. (See the description of Non-built-in Com- 
mand Execution below.) Initialized to the (system- 
dependent) home of the shell. 


The status returned by the last command. If it ter- 
minated abnormally, then 0200 is added to the 
status. Built-in commands that fail return exit 
status 1, all other built-in commands set status 0. 


Controls automatic timing of commands. Time 
takes a numeric argument, which stands for some 
number of CPU seconds. If time is set, the shell 
prints a line of information when any command tak- 
ing more than this many CPU seconds terminates. 
The line gives user, system, and real times, and a 
utilization percentage, which is the ratio of user 
plus system times to real time. 


Set by the -—v command line option, causes the 
words of each command to be printed after history 
substitution. 
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Non-built-in Command Execution 


When the shell finds that a command to be executed is not a built-in 
command, it tries to execute the command via exec(2). Each word 
in the variable path names a directory from which the shell attempts 
to execute the command. If it is given neither a —c nor a —t option, 
the shell hashes the names in these directories into an internal table 
so that it only tries an exec in a directory if there is a possibility that 
the command resides there. This greatly speeds command location 
when the search path contains a large number of directories. If this 
mechanism has been turned off (via unhash), or if the shell is given 
a —c or -t argument, and in any case for each directory component 
of path that does not begin with a /, the shell tries to concatenates 
all the path entries with the given command name to form a path 
name of a file, which it then attempts to execute. 


Parenthesized commands are always executed in a subshell. Thus 
(cd ; pwd) ; pwd does not leave you in the home directory; it 
leaves you where you are, and prints the home directory name fol- 
lowed by the name of the directory you are in. cd ; pwd, on the 
other hand, leaves you in the Home directory. Parenthesized com- 
mands are most often used to prevent chdir from affecting the - 
current shell. 


If the file has execute permissions but is not an executable binary to 
the system, then it is assumed to be a file containing shell com- 
mands and a new shell is spawned to read tt. 


If there is an alias for shell then the words of the alias are 
prepended to the argument list to form the shell command. The first 
word of the alias should be the full path name of the shell (e.g. 
$shell). Note that this is a special, late-occurring, case of alias sub- 
stitution, and only allows words to be prepended to the argument list 
without modification. 


Argument List Processing 


If argument O to the shell is —, then this shell is a login shell. The 
flag arguments are interpreted as follows: 


-—c Commands are read from the (single) following argument, 
which must be present. Any remaining arguments are placed 
in argv. 


-e The shell exits if any invoked command terminates abnormally 
or yields a non-zero exit status. 


-f The shell starts faster, because it neither searches for nor 
executes commands from the file .cshrc in the invoker’s home 
directory. 
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-i The shell is interactive and prompts for its top-level input, even 
if it appears not to be a terminal. Shells are interactive without 
this option if their inputs and outputs are terminals. 


—n Commands are parsed, but not executed. This may aid in 
syntactic checking of shell scripts. 


-s Command input is taken from the standard input. 


—t A single line of input is read and executed. A \ escapes the 
newline at the end of this line to continue onto another line. 


~-v Causes the verbose variable to be set, so command input is 
echoed after history substitution. 


—x Causes the echo variable to be set, so commands are echoed 
immediately before execution. 


-V Causes the verbose variable to be set even before .cshrc is 
executed. 


-X Is to —x as —V is to —v. 


After processing of flag arguments, if arguments remain but none of 
the —c, —i, —s, or —t options is given, the first argument is taken as 
the name of a file of commands to be executed. The shell opens 
this file, and saves its name for possible resubstitution by $0. Many 
system shell procedures are written for use with the standard Sys5, 
whose shell scripts are not compatible with this shell. Therefore, the 
C shell executes such a standard shell if the first character of a 
script is not a #, i.e., if the script does not start with a comment. 
Remaining arguments initialize the variable argv. 


Signal Handling 


The shell normally ignores quit signals. It ignores interrupt signals 
as well if the command is followed by &; otherwise the signals have 
the values the shell inherited from its parent. The shell’s handling of 
interrupts can be controlled by onintr. Login shells catch the ter- 
minate signal; otherwise this signal is passed on to children from the 
state in the shell’s parent. No interrupts are allowed when a login 
shell is reading the file ./ogout. 


“/.cshre Read at beginning of execution by each shell. 
“/.login Read by login shell, after .cshrc at login. 
“/.logout Read by login shell, at logout. 
/oin/sh Standard shell, for shell scripts not 
starting with a #. 
/tmp/sh« Temporary file for <<<. 
/dev/null Source of empty file. 
/etc/passwd Source of home directories for “name. 
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LIMITATIONS 


NOTES 


Words can be no longer than 512 characters. The number of char- 
acters in an argument varies from system to system. The number 
of arguments to a command involving filename expansion is limited 
to 1/6th the number of characters allowed in an argument list. Also 
command substitutions may substitute no more characters than are 
allowed in an argument list. 


To detect looping, the shell restricts the number of alias substititu- 
tions on a single line to 20. 


The Plexus version of the C Shell is based on the one from the 
University of California at Berkeley. 


SEE ALSO 


BUGS 


access(2), exec(2), fork(2), pipe(2), signal(2), umask(2), wait(2), 
a.out(4), environ(5), An Introduction to the C Shell. 


Control structure should be parsed rather than being recognized as 
built-in commands. This would allow control commands to be placed 
anywhere, to be combined with | and to be used with & and ; 
metasyntax. 


Commands within loops, prompted for by ?, are not placed in the 
history list. 


It should be possible to use the : modifiers on the output of com- 
mand substitutions. More than one : modifier should be allowed on 
$ substitutions. 


Some commands should not touch status or it may be so transient 
as to be almost useless. Or-ing in 0200 to status on abnormal ter- 
mination is not elegant. 


The new exec command inherits several open files other than the 
normal standard input and output and diagnostic output. If the input 
and output are redirected and the new command does not close 
these files, some files may be held open unnecessarily. 


A number of bugs are associated with the importing/exporting of the 
PATH. For example, directories in the path using the ~ syntax are 
not expanded in the PATH. Unusual paths, such as (), can cause 
csh to dump core. 


This version of csh does not support or use the process control 
features of the 4th Berkeley Distribution. It contains a number of 
known bugs that have been fixed in the process control version. 
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NAME 
csplit — context spiit 

SYNOPSIS 
csplit [—s] [-k] [-f prefix] file argi [... argn] 

DESCRIPTION 
Csplit reads file and separates it into n+1 sections, defined by the 
arguments arg? ... argn . By default the sections are placed in 
xx0O0 ... xxn (n may not be greater than 99). These sections get 


the following pieces of file : 


00: From the start of file up to (but not including) the line 
referenced by arg7 . 

O01: From the line referenced by arg7 up to the line refer- 
enced by arg2 . 


n+1: From the line referenced by argn to the end of file . 
If the file argument is a — then standard input is used. 
The options to cspilit are: 


—-S Csplit normaily prints the character counts for each 
file created. If the -—s option is present, csplit 
suppresses the printing of all character counts. 


—k Csplit normally removes created files if an error 
occurs. If the —k option is present, cspiit leaves 
previously created files intact. 


—f prefix \f the -f option is used, the created files are named 
prefix00 ... prefixn. Tne default is xx00 ... xxn. 


The arguments (arg? ... argn ) to csplit can be a combination of 
the following: 


/rexp/ A file is to be created for the section from the 
current line up to (but not including) the line contain- 
ing the regular expression rexp . The current line 
becomes the line containing rexp . This argument 
may be followed by an optional + or — some 
number of lines (e.g., /Page/—5). 


“ol XP Yo 
This argument is the same as /rexp/, except that no 
file is created for the section. 


Inno A file is to be created from the current line up to (but 
not including) /nno . The current line becomes Inno . 
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{num} Repeat argument. This argument may follow any of 
the above arguments. If it follows a rexp type argu- 
ment, that argument is applied num more times. If tt 
follows Inno , the file will be split every Inno lines 
(num times) from that point. 


Enclose all rexp type arguments that contain blanks or other char- 
acters meaningful to the Shell in the appropriate quotes. Regular 
expressions may not contain embedded new-lines. Csplit does not 
affect the original file; it is the users responsibility to remove it. 


EXAMPLES 
csplit -f cobol file ‘/procedure division’ /par5./ /par16./ 


This example creates four files, cobol00 ...cobolQ3. After editing 
the “split” files, they can be recombined as follows: 


cat cobol0[O—3] > file 
Note that this example overwrites the original file. 
csplit —-k file 100 {99} 


This example would split the file at every 100 lines, up to 10,000 
lines. The —k option causes the created files to be retained if there 
are less than 10,000 lines; however, an error message would still be 
printed. 


csplit -k prog.c ‘%main(%’ '/'/+1" {20} 


Assuming that prog.c follows the normal C coding convention of 
ending routines with a } at the beginning of the line, this example will 
create a file containing each separate C routine (up to 21) in prog.c 


SEE ALSO 
ed(1), sh(1). 
regexp(5) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 
Self explanatory except for: 
arg — Out of range 
which means that the given argument did not reference a line 
between the current position and the end of the file. 
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NAME 
ct — spawn getty to a remote terminal 


SYNOPSIS 
ct {[ -—h ] [ -v ] [ -w n ] [ -S Speed ] telno ... 


DESCRIPTION 
Ct dials the phone number of a modem that is attached to a termi- 
nal, and spawns a getty process to that terminal. Te/no is a tele- 
phone number, with equal signs for secondary dial tones and minus 
signs for delays at appropriate places. If more than one telephone 
number is specified, ct will try each in succession until one answers; 
this is useful for specifying alternate dialing paths. 


Ct will try each line listed in the file /usr/lib/uucp/L-devices until it 
finds an available line with appropriate attributes or runs out of 
entries. If there are no free lines, ct will ask if it should wait for one, 
and if so, for how many minutes it should wait before it gives up. Cf 
will continue to try to open the dialers at one-minute intervals until 
the specified limit is exceeded. The dialogue may be overridden by 
specifying the —wn option, where rn is the maximum number of 
minutes that ct is to wait for a line. 


Normally, ct will hang up the current line, so that that line can 

ie answer the incoming call. The —h option will prevent this action. If 

( the —v option is used, ct will send a running narrative to the stan- 
dard error output stream. 


The data rate may be set with the —s option, where speed is 
expressed in baud. The default rate is 300. 


After the user on the destination terminal logs out, ct prompts, 
Reconnect? If the response begins with the letter n the line will be 
dropped; otherwise, getty will be started again and the login: 
prompt will be printed. 


Of course, the destination terminal must be attached to a modem 
that can answer the telephone. 


FILES 
/usr/ib/uucp/L-devices 
/usr/adm/ctlog 


SEE ALSO 
cu(1C), login(1), uucp(1C). 
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NAME 
ctags — create a tags file 


SYNOPSIS 
/usr/plx/ctags [ -—u ] [ -w ] [ -—x ] name ... 


DESCRIPTION 

Ctags makes a tags file for ex(1) from the specified C, Pascal and 
Fortran sources. A tags file gives the locations of specified objects 
(in this case functions) in a group of files. Each line of the tags file 
contains the function name, the file in which it is defined, and a 
scanning pattern used to find the function definition. These are given 
in separate fields on the line, separated by blanks or tabs. Using 
the tags file, ex can quickly find these function definitions. 


If the —x flag is given, ctags produces a list of function names, the 
line number and file name on which each is defined, as well as the 
text of that line and prints this on the standard output. This is a sim- 
ple index which can be printed out as an off-line readable function 
index. 


Files whose name ends in .c or .h are assumed to be C source files 
and are searched for C routine and macro definitions. Others are 
first examined to see if they contain any Pascal or Fortran routine 
definitions; if not, they are processed again looking for C definitions. 


Other options are: 
-w suppressing warning diagnostics. 


-—u causing the specified files to be updated in tags, that is, ail 
references to them are deleted, and the new values are 
appended to the file. (Beware: this option is implemented in a 
way that is rather slow; it is usually faster to simply rebuild the 
tags file.) 


The tag main is treated specially in C programs. The tag formed is 
created by prepending M to the name of the file, with a trailing .c 
removed, if any, and leading pathname components also removed. 
This makes use of ctags practical in directories with more than one 
program. 


FILES 
tags output tags file 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
ex(1), vi(1). 
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BUGS 
Recognition of functions, subroutines and procedures for FOR- 
TRAN and Pascal is done is a very simpleminded way. No attempt 
is made to deal with block structure; if you have two Pascal pro- 
cedures in different blocks with the same name, it won't work. 


The method of deciding whether to look for C or Pascal and FOR- 
TRAN functions is not very sophisticated. 
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NAME 


ctrace — C program debugger 


SYNOPSIS 


ctrace [ options | [ file ] 


DESCRIPTION 
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Ctrace allows you to follow the execution of a C program, statement 
by statement. The effect is similar to executing a shell procedure 
with the -x option. Ctrace reads the C program in file (or from stan- 
dard input if you do not specify file), inserts statements to print the 
text of each executable statement and the values of all variables 
referenced or modified, and writes the modified program to the stan- 
dard output. You must put the output of ctrace into a temporary file 
because the cc(1) command does not allow the use of a pipe. You 
then compile and execute this file. 


As each statement in the program executes it will be listed at the 
terminal, followed by the name and value of any variables refer- 
enced or modified in the statement, followed by any output from the 
statement. Loops in the trace output are detected and tracing is 
stopped until the loop is exited or a different sequence of state- 
ments within the loop is executed. A warning message is printed 
every 1000 times through the loop to help you detect infinite loops. 
The trace output goes to the standard output so you can put it into a 
file for examination with an editor or the bfs(1) or tai(1) commands. 


The only options you will commonly use are: 


-f functions Trace only these functions. 
-v functions — Trace all but these functions. 


You may want to add to the default formats for printing variables. 
Long and pointer variables are always printed as signed integers. 
Pointers to character arrays are also printed as strings if appropri- 
ate. Char, short, and int variables are also printed as signed 
integers and, if appropriate, as characters. Double variables are 
printed as floating point numbers in scientific notation. You can 
request that variables be printed in additional formats, if appropriate, 
with these options: | 


-O Octal 

—X Hexadecimal 
—Uu Unsigned 

-e Floating point 


These options are used only in special circumstances: 


-In Check n consecutively executed statements for looping 
trace output, instead of the default of 20. Use 0 to get all 
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the trace output from loops. pm 

-S Suppress redundant trace output from simple assignment | 
statements and string copy function calls. This option can 
hide a bug caused by use of the = operator in place of the 
== operator. | 

-tn Trace n variables per statement instead of the default of 10 
(the maximum number is 20). The Diagnostics section 
explains when to use this option. 


—P Run the C preprocessor on the input before tracing it. You 
can also use the -D , -l , and -U cc (1) preprocessor 
options. 


These options are used to tailor the run-time trace package when 
the traced program will run in a non-UNIX system environment: 


-b Use only basic functions in the trace code, that is, those in 
ctype (3C), printf (3S), and string (3C). These are usually 
available even in cross-compilers for microprocessors. In 
particular, this option is needed when the traced program 
runs under an operating system that does not have signal 
(2), fflush (3S), longjmp (3C), or setimp (3C). 
Change the trace print function from the default of ‘printf(’. 
For example, ‘fprintf(stderr, would send the trace to the -~ 
standard error output. ' j 
rf Use file f in place of the runtime.c trace function package. ~~ 
This lets you change the entire print function, instead of just 
the name and leading arguments (see the -p option). 


EXAMPLE 
If the file ic.c contains this C program: 
1 #include <stdio.h> 


2 main() /* count lines in input */ 

3 { 

4 int c, nl; 

5 

6 ni = QO; 

7 while ((c = getchar()) != EOF). 

8 if (c = \n) 

9 ++nl; 10 printf("%d\n", nl); 11 } and 


you enter these commands and test data: cc Ic.c a.out 1 (cnti-d), 
the program will be compiled and executed. The output of the pro- 
gram will be the number 2, which is not correct because there is 
only one line in the test data. The error in this program is common, 
but subtle. If you invoke ctrace with these commands: ctrace Ic.c 
>temp.c cc temp.c a.out the output will be: 

2 main() 


- 


May 27, 1985 Page 2 


CTRACE(1) UNIX Sys5 CTRACE(1) 


6 nl = O; 

*nl==0%*/ 
7 while ((c = getchar()) != EOF) The program is now waiting 
for input. If you enter the same test data as before, the output will 
be: 

*c == 49or'1 */ 
8 if (c = \n) 

/*c == 100r \n' */ 
9 ++nl; 
mral==1%/ 


7 while ((c = getchar()) != EOF) 
/*¢ == 100r \n */ 


8 if (c = ‘\n’) 
/*“c == 100r \n'*/ 
9 + +nl:; 
| *nal==2*/ 
7 while ((c = getchar()) != EOF) If you now enter an end of 


file character (cntl-d) the final output will be: 
*c == -1%*/ 10 printf("Yod\n"", nl); 
/*nl== 2 */2 return | 


Note that the program output printed at the end of the trace line for 
the nl variable. Also note the return comment added by ctrace at 
the end of the trace output. This shows the implicit return at the ter- 
minating brace in the function. 


The trace output shows that variable ¢ is assigned the value ‘1’ in 
line 7, but in line 8 it has the value ‘\n’. Once your attention is 
drawn to this if statement, you will probably realize that you used 
the assignment operator (=) in place of the equal operator (==). 
You can easily miss this error during code reading. 


EXECUTION-TIME TRACE CONTROL 
The default operation for ctrace is to trace the entire program file, 
unless you use the -f or -v options to trace specific functions. This 
does not give you statement by statement control of the tracing, nor 
does it let you turn the tracing off and on when executing the traced 
program. 


You can do both of these by adding ctroff () and ctron () function 
calls to your program to turn the tracing off and on, respectively, at 
execution time. Thus, you can code arbitrarily complex criteria for 
trace control with if statements, and you can even conditionally 
include this code because ctrace defines the CTRACE preprocessor 
variable. For example: 
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#ifdef CTRACE 
if (c == ' && i > 1000) 
ctron(); 
#endif 


You can also call these functions from sdb (1) if you compile with 
the -g.option. For example, to trace ail but lines 7 to 10 in the main 
function, enter: | 


sdb a.out 
main:7b ctroff() 
main:11b ctron() 
: 


You can also turn the trace off and on by seiting static variable 
tr_ct_ to O and 1, respectively. This is useful if you are using a 
debugger that cannot call these functions directly, such as adb (7). 


DIAGNOSTICS 
This section contains diagnostic messages from both ctrace and cc 
(1), since the traced code often gets some cc warning messages. 


You can get cc error messages in some rare cases, all of which can 


be avoided. 


Ctrace Diagnostics 
warning: some variables are not traced in this statement 
Only 10 variables are traced in a statement to prevent the C 
compiler “out of tree space; simplify expression” error. Use 
the -t option to increase this number. | 


warning: statement too long to trace 
This statement is over 400 characters long. Make sure that 
you are using tabs to indent your code, not spaces. 


cannot handle preprocessor code, use -P option 
This is usually caused by #ifdef/#endif preprocessor state- 
ments in the middle of a C statement, or by a semicolon at 
the end of a #define preprocessor statement. 


‘if... else if sequence too long 
Split the sequence by removing an else from the middle. 


possible syntax error, try -P option 
Use the -P option to preprocess the ctrace input, along with 
any appropriate -D , -l, and -U preprocessor options. If you 
still get the error message, check the Warnings section 
below. 
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Cc Diagnostics 


warning: floating point not implemented 
warning: illegal combination of pointer and integer 
warning: statement not reached 
warning: sizeof returns O 
Ignore these messages. 


compiler takes size of function 
See the ctrace "possible syntax error” message above. 


yacc stack overflow 
See the ctrace "if ... else if’ sequence too long" message 
above. 


out of tree space; simplify expression 
Use the -t option to reduce the number of traced variables 
per statement from the default of 10. Ignore the "ctrace: too 
many variables to trace" warnings you will now get. 


redecliaration of signal 
Either correct this declaration of signal (2), or remove it and 
#include <signal.h>. 


WARNINGS 


BUGS 
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You will get a ctrace syntax error if you omit the semicolon at the 
end of the last element declaration in a structure or union, just 
before the right brace (}). This is optional in some C compilers. 


Defining a function with the same name as a system function may 
cause a syntax error if the number of arguments is changed. Just 
use a different name. 


Ctrace assumes that BADMAG is a preprocessor macro, and that 
EOF and NULL are #defined constants. Declaring any of these to 
be variables, e.g. “int EOF;", will cause a syntax error. 


Ctrace does not know about the components of aggregates like 
structures, unions, and arrays. It cannot choose a format to print all 
the components of an aggregate when an assignment is made to 
the entire aggregate. Ctrace may choose to print the address of an 
aggregate or use the wrong format (e.g., %e for a structure with two 
integer members) when printing the value of an aggregate. 


Pointer values are always treated as pointers to character strings. 


The loop trace output elimination is done separately for each file of 
a multi-file program. This can result in functions called from a loop 
still being traced, or the elimination of trace output from one function 
in a file until another in the same file is called. 
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FILES | a 


runtime.c run-time trace package 


SEE ALSO 
signal(2), ctype(3C), fflush(3S), longjmp(3C), printf(3S), setimp(3C), 
string(3C) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
cu — call another UNIX system 


SYNOPSIS 
cu [-sspeed] [-lline] [-h] [-t] [-d] [-m] [-o] [-e] [-n] 
telno | systemname | dir 


DESCRIPTION 
Cu calls up another UNIX system, a terminal, or possibly a non-UNIX 
system. It manages an interactive conversation with possible 
transfers of ASCII files. 


cu accepts the following options and arguments. 


-—sspeed 
Specifies the transmission speed(110, 150, 300, 600, 1200, 
4800, 9600); 300 is the default value. Most modems are 
either 300 or 1200 baud. Directly connected lines may be 
set to a speed higher than 1200 baud. 


-lline Specifies a device name to use as the communication line. 
This can be used to override searching for the first available 
line having the right speed. When the -! option is used 
without the -s option, the speed of a line is taken from the 
file /usr/lib/uucp/L-devices. When the -| and -s options are 
used simultaneously, cu will search the L-devices file to 
check if the requested speed for the requested line is avail- 
able. If so, the connection will be made at the requested 
speed; otherwise an error message will be printed and the 
call will not be made. The specified device is generally a 
directly connected asynchronous line (e.g., /dev/ttyab), in 
this case a phone number is not required but the string dir 
may be use to specify a null acu. If the specified device is 
associated with an auto dialer, a phone number must be 
provided. 


—h Emulates local echo, supporting calls to other computer sys- 
tems which expect terminals to be set to half-duplex mode. 


—t Used when dialing an ASCII terminal which has been set to 
auto answer. Appropriate mapping of cCarriage-return to 
carriage-return-line-feed pairs Is set. 


-d Causes diagnostic traces to be printed. 


-e Designates that even parity is to be generated for data sent 
to the remote. 


-O Designates that odd parity is to be generated for data sent 
to the remote. 
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Designates a direct line which has modem control. 


Will request the phone number to be dialed from the user 
rather than taking it from the command line. 


When using an automatic dialer the argument is the tele- 
phone number with equal signs for secondary dial tone or 
minus signs for delays, at appropriate places. 


systemname 


dir 


A uucp system name may be used rather than a phone 
number; in this case, cu will obtain an appropriate direct line 
or phone number from ‘usr‘lib‘uucp/L.sys (the appropriate 
baud rate is also read along with phone numbers). Cu will 
try each phone number or direct line for systemname in the 
L.sys file until a connection is made or all the entries are 
tried. 


Using dir insures that cu will use the line specified by the -l 
option. 


After making the connection, cu runs as two processes: the 
transmit process reads data from the standard input and, except for 
lines beginning with ~ , passes it to the remote system; the receive 
process accepts data from the remote system and, except for lines 
beginning with ~ , passes it to the standard output. Normally, an 
automatic DC3/DC1 protocol is used to control input from the remote 
so the buffer is not overrun. Lines beginning with ~ have special 
meanings. 


The transmit process interprets the following: 


terminate the conversation. 


escape to an interactive shell on the local 


system. 
“lomd... run cmd on the local system (via sh —c ). 
“$cmd... run cmd locally and send its output to the 
remote system. 
“%Cd change the directory on the local system. 


NOTE: ‘cd will cause the command to be 
run by a sub-shell; probably not what was 
intended. 


“%take from [ to ]_ copy file from (on the remote system) to file 
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Page 2 


Sian |, 44 
cet 


CU(1C) 


Page 3 


UNIX Sys5 CU(1C) 


“%put from [ to | copy file from (on local system) to file to on 
remote system. If to is omitted, the from 
argument is used in both places. 


= de send the line ~ ... to the remote system. 
“%break transmit a BREAK to the remote system. 
“Ynostop toggles between DC3/DC1 input control proto- 


col and no input control. This is useful in 
case the remote system is one which does 
not respond properly to the DC3 and DC1 
characters. 


The receive process normally copies data from the remote system 
to its standard output. A line from the remote that begins with “> 
initiates an output diversion to a file. The complete sequence is: 


“>[>]: file 

zero or more lines to be written to file 

“> 
Data from the remote is diverted (or appended, if >> is used) to file 
. The trailing “> terminates the diversion. 


The use of “%put requires stty (1) and cat (7) on the remote side. 
It also requires that the current erase and kill characters on the 
remote system be identical to the current ones on the local system. 
Backslashes are inserted at appropriate places. 


The use of “%take requires the existence of echo (7) and cat (1) on 
the remote system. Also, stty tabs mode should be set on the 
remote system if tabs are to be copied without expansion. 


When cu is used on system X to connect to system Y and subse- 
quently used on system Y to connect to system Z, commands on 
system Y can be executed by using ~~. For example, uname can be 
executed on Z, X, and Y as follows: 


uname 

Z 

“luname 

X 

~luname 

Y 

In general, ~ causes the command to be executed on the original 
machine, ~ causes the command to be executed on the next 
machine in the chain. 
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EXAMPLES 
To dial a system whose number is 9 201 555 1212 using 1200 
baud: 
cu -S1200 9=2015551212 


lf the speed is not specified, 300 is the default value. 


To login to a system connected by a direct line: 
cu -l ;dev:ttyXX dir 

To dial a system with the specific line and a specific speed: 
cu -si200 -l ‘dev ttyXX dir 

To dial a system using a specific line: 
cu -| ;devculXX 2015551212 


To use a system name: 
Cu YY YZ2Z 


1 fant C.. 


FILES 
/usrlib/uucp/L.sys 
‘usr/lib/uucp/L-devices 
/usr’spool/uucp/LCK..(tty-device) 
‘dev: null 

SEE ALSO 


cat(1), ct(1C), echo(1), stty(1), uname(1), uucp(1C). 


DIAGNOSTICS 
— Exit code is zero for normal exit, non-zero (various values) other- 
wise. 


BUGS 
Cu buffers input internally. 
There is an artificial slowing of transmission by cu during the “%put 
operation so that loss of data is unlikely. 
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cut — cut out selected fields of each line of a file 


SYNOPSIS 


cut —clist [file1 file2 ...] 
cut -flist [(-d char] [-s] [file1 file2 ...] 


DESCRIPTION 


HINTS 
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Use cut to cut out columns from a table or fields from each line of a 
file; in data base parlance, it implements the projection of a relation. 
The fields as specified by fist can be fixed length, i.e., character 
positions as on a punched card (-c option) or the length can vary 
from line to line and be marked with a field delimiter character like 
tab (-f option). Cut can be used as a filter; if no files are given, the 
standard input is used. 


The meanings of the options are: 


list A comma-separated list of integer field numbers (in 
increasing order), with optional — to indicate ranges as in 
the —o option of nroff / troff for page ranges; e.g., 1,4,7 ; 
1-3,8 ; -5,10 (short for 1-5,10); or 3- (short for third 
through last field). 


-clist The list following —c (no space) specifies character posi- 
tions (e.g., -c1-72 would pass the first 72 characters of 
each line). 


-flist |The list following -f is a list of fields assumed to be 
separated in the file by a delimiter character (see —d ); e.g., 
-f1,7 copies the first and seventh field only. Lines with no 
field delimiters will be passed through intact (useful for 
table subheadings), unless —s is specified. . 


-—dchar The character following —d is the field delimiter (-f option 
only). Default is fab . Space or other characters with spe- 
cial meaning to the shell must be quoted. 


-S Suppresses lines with no delimiter characters in case of —f 
option. Unless specified, lines with no delimiters will be 
passed through untouched. 


Either the —c or -f option must be specified. 


Use grep (1) to make horizontal “cuts” (by context) through a file, 
or paste (1) to put files together column-wise (i.e., horizontally). To 
reorder columns in a table, use cut and paste . 
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EXAMPLES 7 , 
cut —-d: -f1,5 /etc/passwd mapping of user IDs to names 
name-*who am i|cut -f1 -d""* to set name to current login 

name. 

DIAGNOSTICS 
line too long A line can have no more than 1023 characters 


or fields. 


bad list for c/f option 

7 Missing -—c or -f option or incorrectly specified 
list . No error occurs if a line has fewer fields 
than the /ist calls for. 


no fields The list is empty. 


SEE ALSO 
grep(1), paste(1). 
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NAME 
cxref — generate C program cross-reference 
SYNOPSIS 
cxref [ options ] files 
DESCRIPTION 
Cxref analyzes a collection of C files and attempts to build a cross- 
reference table. Cxref utilizes a special version of cpp to include 
#define ‘d information in its symbol table. It produces a listing on 
standard output of all symbols (auto, static, and global) in each file 
separately, or with the —c option, in combination. Each symbol con- 
tains an asterisk (*) before the declaring reference. 
In addition to the -D , -l and —U options (which are identical to their 
interpretation by cc (1)), the following options are interpreted by 
cxref : 
-—C Print a combined cross-reference of all input files. 
-w<num> 
Width option which formats output no wider than <num> 
(decimal) columns. This option will default to 80 if <num> 
is not specified or is less than 51. 
-o file Direct output to named file. 
-S Operate silently; does not print input file names. 
-t Format listing for 80-column width. 
FILES 
/ust/lib/xcpp special version of C-preprocessor. 
SEE ALSO 
cc(1). 
DIAGNOSTICS 


Error messages are unusually cryptic, but usually mean that you 
cannot compile these files, anyway. 


BUGS 
Cxref considers a formal argument in a #define macro definition to 
be a declaration of that symbol. For example, a program that 
#include s ctype.h , will contain many declarations of the variable c 
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NAME 


date — print and set the date 


SYNOPSIS 


date [ mmddhhmm[yy] ] [ +format ] 


DESCRIPTION 
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If no argument is given, or if the argument begins with +, the 
current date and time are printed. Otherwise, the current date is 
set. The first mm is the month number; dd is the day number in the 
month; hh is the hour number (24 hour system); the second mm is 
the minute number; yy is the last 2 digits of the year number and is 
optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if 
no year is mentioned. The system operates in GMT. Date takes 
care of the conversion to and from local standard and daylight time. 


If the argument begins with +, the output of date is under the con- 
trol of the user. The format for the output is similar to that of the 
first argument to printf (3S). All output fields are of fixed size (zero 
padded if necessary). Each field descriptor is preceded by % and 
will be replaced in the output by its corresponding value. A single % 
is encoded by %%. All other characters are copied to the output 
without change. The string is always terminated with a new-line 
character. | 


Field Descriptors: 

insert a new-line character 
insert a tab character 

month of year — 01 to 12 

day of month — 01 to 31 

last 2 digits of year — 00 to 99 
date as mmddyy 

hour — 00 to 23 

minute — 00 to 59 

second — 00 to 59 

time as HH:MM:SS 

day of year — 001 to 366 

day of week — Sunday = 0 
abbreviated weekday — Sun to Sat 
abbreviated month — Jan to Dec 
time in AM/PM notation 


“sos HAMHEBTO<2a23575 
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EXAMPLE 
date '+DATE: %M/Yod/Yy%n TIME: %H:%M:%S' 
would have generated as output: 
DATE: 08/01/76 


TIME: 14:45:05 

DIAGNOSTICS 

No permission if you are not the super-user and you try to 

change the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character if the field descriptor is not recognizable. 
FILES 

/dev/kmem 
SEE ALSO 


printf(3S) in the Sys5 UNIX Programmer Reference Manual. 
WARNING 

It is a bad practice to change the date while the system is running 

multi-user. 
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dc — desk calculator 


SYNOPSIS 


dc [ file ] 


DESCRIPTION 
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Dc is an arbitrary precision arithmetic package. Ordinarily it 
operates on decimal integers, but one may specify an input base, 
Output base, and a number of fractional digits to be maintained. 
(See bc(1), a preprocessor for dc that provides infix notation and a 
C-like syntax that implements functions. Bc also provides reason- 
able control structures for programs.) The overall structure of dc is 
a stacking (reverse Polish) calculator. If an argument is given, input 
is taken from that file until its end, then from the standard input. 
The following constructions are recognized: 


number 
The value of the number is pushed on the stack. A number 
is an unbroken string of the digits O-9. It may be preceded 
by an underscore (_) to input a negative number. Numbers 
may contain decimal points. ' 


+—-/*%~ 
The top two values on the stack are added (+), subtracted 
(-), multiplied (*), divided (/), remaindered (%), or exponen- 
tiated (“). The two entries are popped off the stack; the result 
is pushed on the stack in their place. Any fractional part of 
an exponent is ignored. 


SX The top of the stack is popped and stored into a register 
named x , where x may be any character. If the s is capital- 
ized, x is treated as a stack and the value is pushed on tt. 


Ix The value in register x is pushed on the stack. The register 
x is not altered. All registers start with zero value. If the | is 
capitalized, register x is treated as a stack and its top value 
is popped onto the main stack. 


The top value on the stack is duplicated. 


p The top value on the stack is printed. The top value remains 
unchanged. P interprets the top of the stack as an ASCII 
string, removes it, and prints it. 


f All values on the stack are printed. 
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exits the program. lf executing a string, the recursion level is 
popped by two. lf q is capitalized, the top value on the stack 
is popped and the string execution level is popped by that 
value. 


treats the top element of the stack as a character string and 
executes it as a string of dc commands. 


replaces the number on the top of the stack with its scale fac- 
tor. 


puts the bracketed ASCII string onto the top of the stack. 


<X >X =xX 
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The top two elements of the stack are popped and compared. 
Register x is evaluated if they obey the stated relation. 


replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 


interprets the rest of the line as a UNIX system command. 
All values on the stack are popped. 


The top value on the stack is popped and used as the 
number radix for further input. | pushes the input base on the 
top of the stack. 


The top value on the stack is popped and used as the 
number radix for further output. 


pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is used as a 
non-negative scale factor: the appropriate number of places 
are printed on output, and maintained during multiplication, 
division, and exponentiation. The interaction of scale factor, 
input base, and output base will be reasonable if all are 
changed together. 


The stack level is pushed onto the stack. 
replaces the number on the top of the stack with its length. 


A line of input is taken from the input source (usually the ter- 
minal) and executed. 


are used by bc for array operations. 
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EXAMPLE 
This example prints the first ten values of n!: 


[lai +dsa*pla10>y]sy 
Qsal 
lyx 
SEE ALSO 
bc(1). 
DIAGNOSTICS 


x is unimplemented 
where x is an octal number. 


Stack empty 
for not enough elements on the stack to do what was 
asked. 


Out of space 
when the free list is exhausted (too many digits). 


Out of headers 
for too many numbers being kept around. 


Out of pushdown 
for too many items on the stack. 


Nesting Depth 
for too many levels of nested execution. 
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dd — convert and copy a file 


SYNOPSIS 


dd [option=value] ... 


DESCRIPTION 
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Dd copies the specified input file to the specified output with possi- 
ble conversions. The standard input and output are used by default. 
The input and output block size may be specified to take advantage 
of raw physical |/O. 


option values 

if -- file input file name; standard input is default 

of = file output file name; standard output is default 

ibs =n input block size n bytes (default 1024) 

obs =n Output biock size (default 1024) 

bs=n set both input and output block size, superseding 


ibs and obs ; also, if no conversion is specified, it is 
particularly efficient since no in-core copy need be 


done 

cbs=n conversion buffer size 

skip=n skip n input blocks before starting copy 

seek =n seek n blocks from beginning of output file before 
copying 

count=n copy only n input blocks 


conv=ascii convert EBCDIC to ASCIl 
ebcdic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to EBCDIC 
Icase map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 
noerror do not stop processing on an error 
sync pad every input block to /bs 
flip invert bits for P/35 compatibility. 
wasye+- SEVEral Comma-Separated conversions 


Where sizes are specified, a number of bytes is expected. A 
number may end with k , b , or w to specify multiplication by 1024, 
512, or 2, respectively; a pair of numbers may be separated by x to 
indicate a product. 


Cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, 
converted to ASCII, and trailing blanks trimmed and new-line added 
before sending the line to the output. In the latter case ASCII char- 
acters are read into the conversion buffer, converted to EBCDIC, and 
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blanks added to make up an output block of size cbs . a 
After completion, dd reports the number of whole and partial input ~<. 
and output blocks. 

EXAMPLE 


This command will read an EBCDIC tape blocked ten 80-byte 
EBCDIC card images per block into the ASCII file x : 


dd if- devirmt'Om of x ibs 800 cbs-.80 conv ascii,lcase 


Note the use of raw magtape. Dd is especially suited to I/O on the 
raw physical devices because it allows reading and writing in arbi- 
trary block sizes. 


SEE ALSO 
cp(1). 

DIAGNOSTICS 
f+p blocks in(out) numbers of fulf and partial blocks 
read(written) 


NOTES 
Plexus provides a standalone version of dd in addition to the one 
that runs under Sys5. 


BUGS 
The ASCIVEBCDIC conversion tables are taken from the 256- \ / 
character standard in the CACM Nov, 1968. The ibm conversion, 

while less blessed as a standard, corresponds better to certain IBM 

print train conventions. There is no universal solution. 


New-lines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. These should be separate options. 
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NAME 


delta — make a delta (change) to an SCCS file 


SYNOPSIS 


delta [-rSID] [-s] [-n] [-glist] [—m[mrlist]] [-y[comment]] [-p] 
files 


DESCRIPTION 
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Delta is used to permanently introduce into the named SCCS file 
changes that were made to the file retrieved by get (7) (called the 
g-file , or generated file). 


Delta makes a delta to each named SCCS file. If a directory Is 
named, delta behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last com- 
ponent of the path name does not begin with s.) and unreadable 
files are silently ignored. If a name of — is given, the standard input 
is read (see WARNINGS); each line of the standard input is taken to 
be the name of an SCCS file to be processed. 


Delta may issue prompts on the standard output depending upon 
certain keyletters specified and flags (see admin (1)) that may be 
present in the SCCS file (see —m and —-y keyletters below). 


Keyletter arguments apply independently to each named file. 


-rs/D Uniquely identifies which delta is to be made 
to the SCCS file. The use of this keyletter is 
necessary only if two or more outstanding get 
S for editing (get -e) on the same SCCS file 
were done by the same person (login name). 
The SID value specified with the -r keyletter 
can be either the SID specified on the get 
command line or the SID to be made as 
reported by the get command (see get (17)). 
A diagnostic results if the specified SID is 
ambiguous, or, if necessary and omitted on 

the command line. 


-S Suppresses the issue, on the standard out- 
put, of the created delta’s SID, as well as the 
number of lines inserted, deleted and 
unchanged in the SCCS file. 


—n Specifies retention of the edited g-file (nor- 
mally removed at completion of delta pro- 
cessing). 

—glist Specifies a list (see get (1) for the definition 


of list) of deltas which are to be ignored when 
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the file is accessed at the change level (SID) 
created by this delta. 


If the SCCS file has the v flag set (see admin 
(1)) then a Modification Request (MR) 
number must be supplied as the reason for 
creating the new delta. 


If -m is not used and the standard input is a 
terminal, the prompt MRs? is issued on the 
standard output before the standard input is 
read; if the standard input is not a terminal, 
no prompt is issued. The MRs? prompt 
always precedes the comments? prompt 
(see —y keyletter). 


MRs in a list are separated by blanks and/or 
tab characters. An unescaped new-line char- 
acter terminates the MR list. 


Note that if the v flag has a value (see admin 
(1)), it is taken to be the name of a program 
(or shell procedure) which will validate the 
correctness of the MR numbers. If a non- 
zero exit status is returned from MR number 
validation program, delta terminates (it is 
assumed that the MR numbers were not all 
valid). 


Arbitrary text used to describe the reason for 
making the delta. A null string is considered 
a valid comment. 


If ~y is not specified and the standard input is 
a terminal, the prompt comments? is issued 
on the standard output before the standard 
input is read; if the standard input is not a ter- 
minal, no prompt is issued. An unescaped 
new-line character terminates the comment 
text. 


Causes delta to print (on the standard output) 
the SCCS file differences before and after the 
delta is applied in a diff (1) format. 


All files of the form ?- file are explained in the Source Code Control 
System User Guide. The naming convention for these files is also 


described there. 
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g-file Existed before the execution of delta ; removed after 
completion of celta . 

p-file Existed before the execution of delta ; may exist after 
completion of delta . 

q-file Created during the execution of delta ; removed after 
completion of delta . 

x-file Created during the execution of delta ; renamed to 
SCCS file after completion of delta . 

z-file Created during the execution of delta ; removed dur- 
ing the execution of delta . 

d-file Created during the execution of delta ; removed after 


completion of delta . 
/usr/bin/odiff Program to compute differences between the “gotten” 
file and the g-file . 


WARNINGS 


Lines beginning with an SOH ASCII character (binary 001) cannot be 
placed in the SCCS file unless the SOH is escaped. This character 
has special meaning to SCCS (see sccsfile(4) (5)) and will cause an 
error. 


A get of many SCCS files, followed by a delta of those files, should 
be avoided when the get generates a large amount of data. 
Instead, multiple get/delta sequences should be used. 


If the standard input (—) is specified on the delta command line, the 
—m (if necessary) and —y kKeyletters must also be present. Omis- 
sion of these keyletters causes an error to occur. 


Comments are limited to text strings of at most 512 characters. 


SEE ALSO 


admin(1), bdiff(1), cdce(1), get(1), help(1), prs(1), rmdel(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide. | 


DIAGNOSTICS 
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Use help (1) for explanations. 
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NAME 


deroff — remove nroff/troff, tbl, and eqn constructs 


SYNOPSIS 


deroff [ —w ] [ —mx ] [ files ] 


DESCRIPTION 


Deroff reads each of the files in sequence and removes all troff(1) 
requests, macro calls, backslash constructs, eqn(1) constructs 
(between .EQ and .EN lines, and between delimiters), and fb/(1) 
descriptions, and writes the remainder of the file on the standard 
Output. Deroff follows chains of included files (.so and .nx troff 
commands); if a file has already been included, a .so naming that 
file is ignored and a .nx naming that file terminates execution. If no 
input file is given, deroff reads the standard input. 


The —m option may be followed by an m, s, or |. The resulting 
—mm or —ms option causes the mm or ms macros to be interpreted 
so that only running text is output (i.e., no text from macro lines.) 
The —ml option forces the -mm option and also causes deletion of 
lists associated with the mm macros. 


If the —w option is given, the output is a word list, one “word” per 
line, with all other characters deleted. Otherwise, the output follows 
the original, with the deletions mentioned above. In text, a “word” is 
any string that contains at least two letters and is composed of 
letters, digits, ampersands (&), and apostrophes (’); in a macro call, 
however, a “word” is a string that begins with at least two letters 
and contains a total of at least three letters. Delimiters are any 
characters other than letters, digits, apostrophes, and ampersands. 
Trailing apostrophes and ampersands are removed from “words.” 


SEE ALSO 


BUGS 
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eqn(1), tbl(1), troff(1). 


Deroff is not a complete troff interpreter, so it can be confused by 
subtle constructs. In particular, the output of .tl requests is a bit 
bizarre. Most such errors result in too much rather than too little 
output. 

The —ml option does not handle nested lists correctly. 
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NAME 
dial — dial a Racal-Vadic 3451 modem 
mdial — dial the P/75 onboard modem. 


SYNOPSIS 
dial devname speed phone# 
mdial devname speed phone# 


DESCRIPTION 
These programs dial two specific types of modems. dial works with 
a Racal-Vadic 3451 modem. mdial works with a P/75’s onboard 
CH1770 modem. 


The first parameter is the name of the device used to access the 
modems, for example, ttyO or modem. The second parameter is 
the speed to use, 300 or 1200 baud, and the third parameter is the 
phone number that is fed to the modem. 


The programs will provide various exit codes depending on what 
happened: 


exit(0) - Connection was made. 

exit(1) - Parameter error. 

exit(2) - Can't use dialer tty in some way. 
exit(3) - Dialer indicated no answer. 
exit(4) - Dialer not responding. 
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( NAME 
= diff — differential file comparator 


SYNOPSIS 
diff [ —efbh | file1 file2 


DESCRIPTION 
Diff tells what lines must be changed in two files to bring them into 
agreement. If file? (file2) is — , the standard input is used. If file7 
(file2) is a directory, then a file in that directory with the name file2 
(file1) is used. The normal output contains lines of these forms: 


nt an3,n4 
ni,n2dan3 
n1,n2 ¢n3,n4 


These lines resemble ed commands to convert file? into file2 . The 
numbers after the letters pertain to file2 . In fact, by exchanging a 
for d and reading backward one may ascertain equally how to con- 
vert file2 into file1 . As in ed , identical pairs, where n? = n2 or n3 
= n4, are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in 
the first file flagged by <, then ail the lines that are affected in the 
( : second file flagged by >. 


a The —b option causes trailing blanks (spaces and tabs) to be 
ignored and other strings of blanks to compare equal. 


The -e option produces a script of a, c , and d commands for the 
editor ed , which will recreate file2 from file? . The —f option pro- 
duces a similar script, not useful with ed , in the opposite order. In 
connection with -e , the following shell program may help maintain 
multiple versions of a file. Only an ancestral file ($1) and a chain of 
version-to-version ed scripts ($2,$3,...) made by diff need be on 
hand. A “latest version” appears on the standard output. 


(shift; cat $«; echo ‘1,$p’) | ed — $1 


Except in rare circumstances, diff finds a smallest sufficient set of 
file differences. 


Option -h does a fast, half-hearted job. It works only when 
changed stretches are short and well separated, but does work on 
files of unlimited length. Options -e and -f are unavailable with -h. 


FILES 
/tmp/d????? 
oo /usr/lib/diffh for —h 
( SEE ALSO 


cmp(1), comm(1), ed(1). 
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DIAGNOSTICS 
Exit status is 0 for no differences, 1 for some differences, 2 for trou- 
ble. 


BUGS 
Editing scripts produced under the -e or -f option are naive 
about creating lines consisting of a single period (.). 


WARNINGS 
Missing newline at end of file X 
indicates that the last line of file X did not have a new-line. If 
the lines are different, they will be flagged and output; 
although the output will seem to indicate they are the same. 
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NAME 
diff3 — 3-way differential file comparison 
SYNOPSIS 
diff3 [| -ex3 | file1 file2 file3 
DESCRIPTION 
Diff3 compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 
et ee all three files differ 
===>] file! is different 
====2 file2 is different 
====9 file3 is different 
The type of change suffered in converting a given range of a given 
file to some other is indicated in one of these ways: 
f:nia Text is to be appended after line number 
n? infilef, where f = 1, 2, or 3. 
f:nt,n2c Text is to be changed in the range line n7 
to line n2. If nf? =n 2, the range may be 
abbreviated ton? . 
The original contents of the range follows immediately after a ¢ indi- 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 
Under the —e option, diff3 publishes a script for the editor ed that 
will incorporate into file? all changes between file2 and file3 , i.e., 
the changes that normally would be flagged = === and === =3. 
Option -x (-—3) produces a script to incorporate only changes 
flagged ==== (====3). The following command will apply the 
resulting script to file? . 
(cat script; echo '1,$p’) | ed — file1 
FILES 
/tmp/d3* 
/usrilib/diff3prog 
SEE ALSO 
diff(1). 
BUGS 
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Text lines that consist of a single . will defeat —e . 
Files longer than 64K bytes will not work. 
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NAME 


diffmk — mark differences between files 


SYNOPSIS 


diffmk name1 name2 name3 


DESCRIPTION 


Diffmk compares two versions of a file and creates a third file that 
includes “change mark” commands for nroff or troff (1). Name? and 
name2 are the old and new versions of the file. Diffmk generates 
name3 , which contains the lines of name2 plus inserted formatter 
“change mark” (.mc) requests. When name3 is formatted, changed 
or inserted text is shown by | at the right margin of each line. The 
position of deleted text is shown by a single * . 


lf anyone is so inclined, diffmk can be used to produce listings of C 
(or other) programs with changes marked. A typical command line 
for such use ts: 


diffmk old.c new.c tmp; nroff macs tmp | pr 
where the file macs contains: 


pl 1 
AL 77 
nf 
.20 
Nc * 


The .If request might specify a different line length, depending on 
the nature of the program being printed. The .eo and .ne requests 
are probably needed only for C programs. 


lf the characters | and * are inappropriate, a copy of diffmk can be 
edited to change them (diffmk is a shell procedure). 


SEE ALSO 


BUGS 


Page 1 


diff(1), nroff(1), troff(1). 


Aesthetic considerations may dictate manual adjustment of some 
output. File differences involving only formatting requests may pro- 
duce undesirable output, i.e., replacing .sp by .sp 2 will produce a 
“change mark” on the preceding or following line of output. 
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NAME 

dircmp — directory comparison 
SYNOPSIS 

dircmp [ -—d | [ -s ] [ -wn ] dir1 dir2 
DESCRIPTION 


Dircemp examines dir? and dir2 and generates various tabulated 
information about the contents of the directories. Listings of files that 
are unique to each directory are generated for all the options. If no 
option is entered, a list is output indicating whether the filenames 
common to both directories have the same contents. 


—-d Compare the contents of files with the same name in both 
directories and output a list telling what must be changed in 
the two files to bring them into agreement. The list format ts 
described in diff (7). 


-S Suppress messages about identical files. 


-wn Change the width of the output line to n characters. The 
default width is 72. 


SEE ALSO 
cmp(1), diff(1). 
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NAME 


DU(1) 


du — summarize disk usage 


SYNOPSIS 


du [ -ars ] [ names ] 


DESCRIPTION 


NOTES 


BUGS 
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Du gives the number of blocks contained in all files and (recursively) 
directories within each directory and file specified by the names 
argument. The block count includes the indirect blocks of the file. If 
names is missing, . is used. Blocks are 1024 bytes long. 


The optional argument —s causes only the grand total (for each of 
the specified names ) to be given. The optional argument —a 
Causes an entry to be generated for each file. Absence of either 
Causes an entry to be generated for each directory only. 


Du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The -r option will cause du to generate 
messages in such instances. 


A file with two or more links is counted only once. 


Plexus provides a standalone version of du in addition to the one 
that runs under Sys5. 


If the —a option is not used, non-directories given as arguments are 
not listed. 

lf there are too many distinct linked files, du will count the excess 
files more than once. 

Files with holes in them will get an incorrect block count. 
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NAME 

dump — dump selected parts of an object file 
SYNOPSIS 

/bin/dump [—acfghlorst] [—z name] files 
DESCRIPTION 

The dump command dumps selected parts of each of its object file 

arguments. 

This command will accept both object files and archives of object 

files. It processes each file argument according to one or more of 

the following options: 

-a Dump the archive header of each member of each 
archive file argument. 

-—g Dump the global symbols in the symbol table of an 
archive. 

—f Dump each file header. 

—O Dump each optional header. 

—h Dump section headers. 

-S Dump section contents. 

—r Dump relocation information. 

—| Dump line number information. 

—t Dump symbol table entries. 

-zZ name Dump line number entries for the named function. 

—Cc Dump the string table. 

The following modifiers are used in conjunction with the options 

listed above to modify their capabilities. 

-—d number Dump the section number or range of sections starting 
at number and ending either at the last section number 
or number specified by +d. 

+d number 
Dump sections in the range either beginning with first 
section or beginning with section specified by —d. 

—n name Dump information pertaining only to the named entity. 
This modifier applies to -h , -s ,-r , -I, and -t . 

—p Supress printing of the headers. 

-t index Dump only the indexed symbol table entry. The -t 
used in conjunction with +t , specifies a range of sym- 
bol table entries. 
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+t index Dump the symbol table entries in the range ending with 


the indexed entry. The range begins at the first symbol a 
table entry or at the entry specified by the —t option. ee 
—u Underline the name of the file for emphasis. 
-V Dump information in symbolic representation rather 


than numeric (e.g., C_STATIC instead of 0X02 ). This 
modifier can be used with all the above options except 
—S and --o options of dump. 


—-Z name,number 
Dump line number entry or range of line numbers start- 
ing at number for the named function. 


+2 number 
Dump line numbers starting at either function name or 
number specified by -z, up to number specified by +z 


Blanks separating an option and its modifier are optional. The 
comma separating the name from the number modifying the —z 
option may be replaced by a blank. 


The dump command attempts to format the information it dumps in 
a meaningful way, printing certain information in character, hex, 
octal or decimal representation as appropriate. 


SEE ALSO 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 


dx9700 — prepare troff documents for the Xerox 9700 printer 


SYNOPSIS 


dx9700 name 


DESCRIPTION 


The dx9700 filter is a post-processor for device independent troff 
Output, and produces codes suitable for being sent to a Xerox 9700 
laser printer. 


The single argument to dx9700 should be the name part of the 
—Tname argument given to troff. 


The output of the dx9700 filter should be directed to the input of a 
Xerox 9700 printer. 


Note that the Xerox 9700 treats different point sizes as different 
fonts. Hence, the font tables specified to troff(1) and dx9700 actu- 
ally specify a family of typefaces and point sizes. The font families 
that are supported for the Xerox 9700 and that can be specified to 
troff using the -T option follow: 


name contains 


X97.tim10p Times, 7, 10, and 15 point 
X97.tim12p Times, 9, 12, and 17 point 


SEE ALSO 


BUGS 
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troff(1), troff(5). 


Special fonts for the Xerox 9700 printer are needed to use with this 
post-processor. 
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NAME 

echo — echo arguments 
SYNOPSIS 

echo [ arg ] ... 


DESCRIPTION 
Echo writes its arguments separated by blanks and terminated by a 
new-line on the standard output. It also understands C-like escape 
conventions; beware of conflicts with the shell’s use of \: 


\b backspace 

\c print line without new-line 

\f form-feed 

\n new-line 

\v Carriage return 

\t tab 

\v vertical tab 

\\ backslash 

Wn the 8-bit character whose ASCII code is the 1-, 2- or 
3-digit octal number n , which must start with a 
zero. 


Echo is useful for producing diagnostics in command files and for 
sending known data into a pipe. 


SEE ALSO 
sh(1). 

WARNING 
Csh has an established echo command that only recognizes some 
of the escape sequences. See csh in Sys5 UNIX User Guide. If 
you desire one of the missing sequences, use the full pathname 
/bin/echo. 
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ed, red — text editor 
SYNOPSIS 
ed [ — ] [ -p string ] [ -x ] [ file ] 
red [ — ] [ -p string ] [ -x ] [ file ] 
DESCRIPTION 
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Ed is the standard text editor. If the file argument is given, ed 
simulates an e command (see below) on the named file; that is to 
say, the file is read into ed 's buffer so that it can be edited. The 
optional — suppresses the printing of character counts by e, r, and 
w commands, of diagnostics from e and gq commands, and of the ! 
prompt after a !shell command. The -—p option allows the user to 
specify a prompt string. If -x is present, an x command is simu- 
lated first to handle an encrypted file. Ed operates on a copy of the 
file it is editing; changes made to the copy have no effect on the file 
until a w (write) command is given. The copy of the text being 
edited resides in a temporary file called the buffer . There is only 
one buffer. 


Red is a restricted version of ed. It will only allow editing of files in 
the current directory. It prohibits executing shell commands via 
Ishell command. Attempts to bypass these restrictions result in an 
error message (restricted shell). 


Both ed and red support the fspec (4) formatting capability. After 
including a format specification as the first line of file and invoking 
ed with your terminal in stty -tabs or stty tab3 mode (see stty (7), 
the specified tab stops will automatically be used when scanning file 
. For example, if the first line of a file contained: 
<:t5,10,15 $72:> 

tab stops would be set at columns 5, 10, and 15, and a maximum 
line length of 72 would be imposed. NOTE: while inputting text, tab 
characters when typed are expanded to every eighth column as is 
the default. 


Commands to ed have a simple and regular structure: zero, one, or 
two addresses followed by a single-character command , possibly 
followed by parameters to that command. These addresses specify 
one or more lines in the buffer. Every command that requires 
addresses has default addresses, so that the addresses can very 
often be omitted. 


In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in 
input mode . In this mode, no commands are recognized; all input is 
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merely collected. Input mode is left by typing a period (.) alone at 
the beginning of a line. 


Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some 
commands (e.g., s ) to specify portions of a line that are to be sub- 
stituted. A regular expression (RE) specifies a set of character 
strings. A member of this set of strings is said to be matched by 
the RE. The REs allowed by ed are constructed as follows: 


The following one-character RE s match a single character: 


1.1. An ordinary character (not one of those discussed in 1.2 
below) is a one-character RE that matches itself. 


1.2 A backslash (\) followed by any special character is a one- 
character RE that matches the special character itself. The 
special characters are: 


a. ., *, [, and \ (period, asterisk, left square bracket, and 
backslash, respectively), which are always special, 
except when they appear within square brackets ([]; see 
1.4 below). 


b. * (caret or circumflex), which is special at the beginning 
of an entire RE (see 3.1 and 3.2 below), or when it 
immediately follows the left of a pair of square brackets 
([]) (see 1.4 below). 


c. $ (currency symbol), which is special at the end of an 
entire RE (see 3.2 below). 


d. The character used to bound (i.e., delimit) an entire RE, 
which is special for that RE (for example, see how slash 
(/) is used in the g command, below.) 


1.3 A period (.) is a one-character RE that matches any character 
except new-line. 


1.4 A non-empty string of characters enclosed in square brackets 
({]) is a one-character RE that matches any one character in 
that string. If, however, the first character of the string is a cir- 
cumflex (*), the one-character RE matches any character 
except new-line and the remaining characters in the string. 
The * has this special meaning only if it occurs first in the 
string. The minus (—) may be used to indicate a range of con- 
secutive ASCII characters; for example, [0—9] is equivalent to 
[0123456789]. The — loses this special meaning if it occurs 
first (after an initial *, if any) or last in the string. The right 
square bracket (]) does not terminate such a string when it is 


May 28, 1985 Page 2 


ED(1) 


Page 3 


UNIX Sys5 ED(1) 


the first character within it (after an initial *, if any); e.g., [Ja-f] 
matches either a right square bracket (]) or one of the letters 
a through f inclusive. The four characters listed in 1.2.a 
above stand for themselves within such a string of characters. 


The following rules may be used to construct RE s from one- 
character REs: 


2.1 A one-character RE is a RE that matches whatever the one- 
character RE matches. 


2.2 A one-character RE followed by an asterisk (*) is a RE that 
matches zero or more occurrences of the one-character RE. 
If there is any choice, the longest leftmost string that permits a 
match is chosen. 


2.3. A one-character RE followed by \{m\}, \{m,\}, or m,n\} is a 
RE that matches a range of occurrences of the one-character 
RE. The values of m and n must be non-negative integers 
less than 256; \{m\} matches exactly m occurrences; \{m,\} 
matches at least m occurrences; \{m,n\} matches any 
number of occurrences between m and inclusive. When- 
ever a choice exists, the RE matches as many occurrences as 
possible. 


2.4 The concatenation of REs is a RE that matches the concatena- 
tion of the strings matched by each component of the RE. 


2.5 ARE enclosed between the character sequences \( and \) is a 
RE that matches whatever the unadorned RE matches. 


2.6 The expression \ matches the same string of characters as 
was matched by an expression enclosed between \( and \) 
earlier in the same RE. Here n is a digit; the sub-expression 
specified is that beginning with the n -th occurrence of \( 
counting from the left. For example, the expression *\(.*\)\1$ 
matches a line consisting of two repeated appearances of the 
same string. 


Finally, an entire RE may be constrained to match only an initial 
segment or final segment of a line (or both). 


3.1. A circumflex (*) at the beginning of an entire RE constrains 
that RE to match an initial segment of a line. 


3.2 A currency symbol ($) at the end of an entire RE constrains 
that RE to match a final segment of a line. 


The construction *entire RE$ constrains the entire RE to match the 
entire line. 
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The null RE (e.g., //) is equivalent to the last RE encountered. See 
also the last paragraph before FILES below. 


To understand addressing in ed it is necessary to know that at any 
time there is a current line . Generally speaking, the current line is 
the last line affected by a command; the exact effect on the current 


line 


is discussed under the description of each command. 


Adadresses are constructed as follows: 


1. 


2 
3. 
4 
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The character . addresses the current line. 
The character $ addresses the last line of the buffer. 
A decimal number n addresses the rn -th line of the buffer. 


’x addresses the line marked with the mark name character x 
, which must be a lower-case letter. Lines are marked with 
the k command described below. 


A RE enclosed by slashes (/) addresses the first line found by 
searching forward from the line following the current line 
toward the end of the buffer and stopping at the first line con- 
taining a string matching the RE. If necessary, the search 
wraps around to the beginning of the buffer and continues up 
to and including the current line, so that the entire buffer is 
searched. See also the last paragraph before FILES below. 


A RE enclosed in question marks (?) addresses the first line 
found by searching backward from the line preceding the 
current line toward the beginning of the buffer and stopping at 
the first line containing a string matching the RE. If necessary, 
the search wraps around to the end of the buffer and contin- 
ues up to and including the current line. See also the last 
paragraph before FILES below. 


An address followed by a plus sign (+) or a minus sign (-) 
followed by a decimal number specifies that address plus 
(respectively minus) the indicated number of lines. The plus 
sign may be omitted. 


If an address begins with + or —, the addition or subtraction is 
taken with respect to the current line; e.g, —5 is understood to 
mean .—5. 
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9. If an address ends with + or -, then 1 is added to or sub- 
tracted from the address, respectively. As a consequence of 
this rule and of rule 8 immediately above, the address — refers 
to the line preceding the current line. (To maintain compatibil- 
ity with earlier versions of the editor, the character * in 
addresses is entirely equivalent to ~.) Moreover, trailing + and 
-— characters have a cumulative effect, so — refers to the 
current line less 2. 


10. For convenience, a comma (,) stands for the address pair 1,$, 
while a semicolon (;) stands for the pair .,$. 


Commands may require zero, one, or two addresses. Commands 
that require no addresses regard the presence of an address as an 
error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if 
more addresses are given than such a command requires, the last 
one(s) are used. 


Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, 
the current line (.) is set to the first address, and only then is the 
second address calculated. This feature can be used to determine 
the starting line for forward and backward searches (see rules 5. 
and 6. above). The second address of any two-address sequence 
must correspond to a line that follows, in the buffer, the line 
corresponding to the first address. 


In the following list of ed commands, the default addresses are 
shown in parentheses. The parentheses are not part of the 
address; they show that the given addresses are the default. 


It is generally illegal for more than one command to appear on a 
line. However, any command (except e, f, r, or w ) may be suf- 
fixed by I, n, or p in which case the current line is either listed, num- 
bered or printed, respectively, as discussed below under the /,7n, 
and p commands. 


(.)a 


<text> 


The a ppend command reads the given text and appends it 
after the addressed line; . is left at the last inserted line, or, 
if there were none, at the addressed line. Address 0 is legal 
for this command: it causes the “appended” text to be 
placed at the beginning of the buffer. The maximum 
number of characters that may be entered from a terminal is 
256 per line (including the new-line character). 


May 28, 1985 


p> 


=~ 


a 


ED(1) 


(.)c 


<text> 


e file 


E file 


f file 
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The c hange command deletes the addressed lines, then 
accepts input text that replaces these lines; . is left at the 
last line input, or, if there were none, at the first line that 
was not deleted. 


The d elete command deletes the addressed lines from the 
buffer. The line after the last line deleted becomes the 
current line; if the lines deleted were originally at the end of 
the buffer, the new last line becomes the current line. 


The e dit command causes the entire contents of the buffer 
to be deleted, and then the named file to be read in; . is set 
to the last line of the buffer. If no file name is given, the 
currently-remembered file name, if any, is used (see the f 
command). The number of characters read is typed; file is 
remembered for possible use as a default file name in sub- 
sequent e,r, and w commands. If file is replaced by !, the 
rest of the line is taken to be a shell (sh(1)) command 
whose output is to be read. Such a shell command is not 
remembered as the current file name. See also DIAGNOS- 
TICS below. 


The E dit command is like e , except that the editor does 
not check to see if any changes have been made to the 
buffer since the last w command. 


If file is given, the f ile-name command changes the 
currently-remembered file name to file ; otherwise, it prints 
the currently-remembered file name. 


(1,$)g/RE/comman 
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In the g /jobal command, the first step is to mark every line 
that matches the given RE. Then, for every such line, the 
given command list is executed with . initially set to that 
line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines 
of a multi-line list except the last line must be ended with a 
\; @, /, and c commands and associated input are permit- 
ted. The . terminating input mode may be omitted if it would 
be the last line of the command list . An empty command 
list is equivalent to the p command. Theg, G,v, and V 
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commands are not permitted in the command list . See also 
BUGS and the last paragraph before FILES below. 


(1,$)G/RE/ 


(.)i 


<text> 


In the interactive G lobal command, the first step is to mark 
every line that matches the given RE. Then, for every such 
line, that line is printed, . is changed to that line, and any 
one command (other than one of thea,c,/,9,G,v, 
and V commands) may be input and is executed. After the 
execution of that command, the next marked line is printed, 
and so on; a new-line acts as a null command; an & causes 
the re-execution of the most recent command executed 
within the current invocation of G . Note that the commands 
input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command 
can be terminated by an interrupt signal (ASCII DEL or 
BREAK). 


The h elp command gives a short error message that 
explains the reason for the most recent ? diagnostic. 


The H elp command causes ed to enter a mode in which 
error messages are printed for all subsequent ? diagnostics. 
It will also explain the previous ? if there was one. The H 
command alternately turns this mode on and off; it is initially 
off. 


The / nsert command inserts the given text before the 
addressed line; . is left at the last inserted line, or, if there 
were none, at the addressed line. This command differs 
from the a command only in the placement of the input text. 
Address 0 is not legal for this command. The maximum 
number of characters that may be entered from a terminal is 
256 per line (including the new-line character). 


(.,.+1)j 


(.)kx 


The / oin command joins contiguous lines by removing the 
appropriate new-line characters. If exactly one address is 
given, this command does nothing. 


The mark command marks the addressed line with name x , 
which must be a lower-case letter. The address ‘x then 
addresses this line; . is unchanged. 
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The / ist command prints the addressed lines in an unambi- 
guous way: a few non-printing characters (e.g., tab, back- 
Space ) are represented by (hopefully) mnemonic over- 
strikes. All other non-printing characters are printed in 
octal, and long lines are folded. An / command may be 
appended to any other command other thane, f,r,orw. 


(.,.)ma 
The m ove command repositions the addressed line(s) after 
the line addressed by a . Address O Is legal for a and 
causes the addressed line(s) to be moved to the beginning 
of the file. It is an error if address a falls within the range of 
moved lines; . is left at the last line moved. 


The n umber command prints the addressed lines, preced- 
ing each line by its line number and a tab character; . is left 
at the last line printed. The n command may be appended 
to any other command other thane, f,r, orw. 


The p rint command prints the addressed lines; . is left at 
the last line printed. The p command may be appended to 
any other command other thane, f,r, orw. For example, 
dp deletes the current line and prints the new current line. 


p 
The editor will prompt with a * for all subsequent com- 
mands. The P command alternately turns this mode on and 
off; it is initially off. 

q 
The q uit command causes ed to exit. No automatic write 
of a file is done (but see DIAGNOSTICS below). 

Q 


The editor exits without checking if changes have been 
made in the buffer since the last w command. 


($)r file 
The r ead command reads in the given file after the 
addressed line. If no file name is given, the currently- 
remembered file name, if any, is used (see e and f com- 
mands). The currently-remembered file name is _ not 
changed unless file is the very first file name mentioned 
since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read 
is successful, the number of characters read is typed; . is 
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set to the last line read in. If file is replaced by !, the rest of 
the line is taken to be a shell (sh(1)) command whose out- 
put is to be read. For example, “$r !ls" appends current 
directory to the end of the file being edited. Such a shell 
command is not remembered as the current file name. 


(.,-)S/ RE / replacement / or 
(.,-)S/ RE / replacement ‘g or 
(.,-)S/ RE / replacement 'n n= 1-512 


The s ubstitute command searches each addressed line for 
an occurrence of the specified RE. In each line in which a 
match is found, all (non-overlapped) matched strings are 
replaced by the replacement if the global replacement indi- 
cator g appears after the command. If the global indicator 
does not appear, only the first occurrence of the matched 
string is replaced. If a number n appears after the com- 
mand, only the n th occurrence of the matched string on 
each addressed line is replaced. It is an error for the substi- 
tution to fail on a/l addressed lines. Any character other 
than space or new-line may be used instead of / to delimit 
the RE and the replacement ; . is left at the last line on 
which a substitution occurred. See also the last paragraph 
before FILES below. 


An ampersand (&) appearing in the replacement is 
replaced by the string matching the RE on the current line. 
The special meaning of & in this context may be 
suppressed by preceding it by \. As a more general 
feature, the characters \n, where rn is a digit, are replaced 
by the text matched by the n -th regular subexpression of 
the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined 
by counting occurrences of \( starting from the left. When 
the character % is the only character in the replacement , 
the replacement used in the most recent substitute com- 
mand is used as the replacement in the current substitute 
command. The % loses its special meaning when it is ina 
replacement string of more than one character or is pre- 
ceded by a \. 


A line may be split by substituting a new-line character into 


it. The new-line in the replacement must be escaped by 


(.,-)ta 


preceding it by \. Such substitution cannot be done as part 
of ag or v command list. 


This command acts just like the m command, except that a 
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copy of the addressed lines is placed after address a 
(which may be 0); . is left at the last line of the copy. 


The u ndo command nullifies the effect of the most recent 
command that modified anything in the buffer, namely the 
most recenta,c,d,g,f,/,m,r,s,t,v,G,orv 
command. 


(1,$)v/RE/comman 


This command is the same as the global command g 
except that the command list is executed with . initially set 
to every line that does not match the RE. 


(1,$)V/RE/ 


This command is the same as the interactive global com- 
mand G except that the lines that are marked during the 
first step are those that do not match the RE. 


(1,$)w file 
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The w rite command writes the addressed lines into the 
named file. If the file does not exist, it is created with mode 
666 (readable and writable by everyone), unless your 
umask setting (see sh (17)) dictates otherwise. The 
currently-remembered file name is not changed unless file 
is the very first file name mentioned since ed was invoked. 
If no file name ts given, the currently-remembered file name, 
if any, is used (see e and f commands); . is unchanged. If 
the command is successful, the number of characters writ- 
ten is typed. If file is replaced by !, the rest of the line is 
taken to be a shell (sh(1)) command whose standard input 
is the addressed lines. Such a shell command is not 
remembered as the current file name. 


A key string is demanded from the standard input. Subse- 
quente,r, and w commands will encrypt and decrypt the 
text with this key by the algorithm of crypt (7). An explicitiy 
empty key turns off encryption. 
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($)= 


The line number of the addressed line is typed; . is 
unchanged by this command. 


Ishell command 

The remainder of the line after the ! is sent to the UNIX sys- 
tem shell (sh(1)) to be interpreted as a command. Within 
the text of that command, the unescaped character % is 
replaced with the remembered file name; if a ! appears as 
the first character of the shell command, it is replaced with 
the text of the previous shell command. Thus, !! will repeat 
the last shell command. If any expansion is performed, the 
expanded line is echoed; . is unchanged. 


(.+1) <new-line> 
An address alone on a line causes the addressed line to be 
printed. A new-line alone is equivalent to .+ 1p; it is useful 
for stepping forward through the buffer. 


lf an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and 
returns to its command level. 


some size limitations: 512 characters per line, 256 characters per 
global command list, 64 characters per file name, and 128K charac- 
ters in the buffer. The limit on the number of lines depends on the 
amount of user memory: each line takes 1 word. 


When reading a file, ed discards ASCII NUL characters and all char- 
acters after the last new-line. Files (e.g., a.out ) that contain char- 
acters not in the ASCII set (bit 8 on) cannot be edited by ed . 


If the closing delimiter of a RE or of a replacement string (e.g., /) 
would be the last character before a new-line, that delimiter may be 
omitted, in which case the addressed line is printed. The following 
pairs of commands are equivalent: 

s/$1/S2 S$ $1.S2:p 

g/s1 g/s1.p 

?s1 ?s1? 


itmp/e# temporary; # is the process number. 
ed.hup — work is saved here if the terminal is hung up. 


DIAGNOSTICS 
2 for command errors. 
? file for an inaccessible file. 
(use the A elp and H elp commands for detailed expla- 
nations). 


lf changes have been made in the buffer since the last w command 
that wrote the entire buffer, ed warns the user if an attempt is made 
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to destroy ed ’s buffer via the e or gq commands. It prints ? and 
allows one to continue editing. A second e or gq command at this 
point will take effect. The -— command-line option inhibits this 
feature. 


SEE ALSO 


crypt(1), grep(1), sed(1), sh(1), stty(1). 
fspec(4), regexp(5) in the Sys5 UNIX Programmer Reference 
Manual. 


Sys5 UNIX Editing Guide. 


CAVEATS AND BUGS 


A ! command cannot be subject to a g or a v command. 

The / command and the ! escape from the e , r, and w commands 
cannot be used if the the editor is invoked from a restricted shell 
(see sh (1)). 

The sequence \n in a RE does not match a new-line character. 

The / command mishandles DEL. 

Files encrypted directly with the crypt (7) command with the null key 
cannot be edited. 

Characters are masked to 7 bits on input. 

If the editor input is coming from a command file (i.e., ed file < ed- 
cmd-file), the editor will exit at the first failure of a command that is 
in the command file. . 
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NAME 


edit — text editor (variant of ex for casual users) 


SYNOPSIS 


edit [ —r ] name ... 


DESCRIPTION 


Edit is a variant of the text editor ex recommended for new or 
Casual users who wish to use a command-oriented editor. The fol- 
lowing brief introduction should help you get started with edit. If you 
are using a CRT terminal you may want to learn about the display 
editor vi. 


BRIEF INTRODUCTION 


Page 1 


To edit the contents of an existing file you begin with the command 
“edit filename” to the shell. Eoit makes a copy of the file which you 
can then edit, and tells you how many lines and characters are in 
the file. To create a new file, just make up a name for the file and 
try to run edit on it; you will cause an error diagnostic, but do not 
worry. 


Edit prompts for commands with the character ‘:’, which you should 
see after starting the editor. If you are editing an existing file, then 
you will have some lines in edit’s buffer (its name for the copy of the 
file you are editing). Most commands to edit use its “current line” if 
you do not tell them which line to use. Thus if you say print (which 
can be abbreviated p) and hit carriage return (as you should after ail 
edit commands) this current line will be printed. If you delete (d) 
the current line, edit will print the new current line. When you start 
editing, edit makes the last line of the file the current line. If you 
delete this last line, then the new last line becomes the current one. 
In general, after a delete, the next line in the file becomes the 
current line. (Deleting the last line is a special case.) 


If you start with an empty file or wish to add some new lines, then 
the append (a) command can be used. After you give this com- 
mand (typing a carriage return after the word append) edit will read 
lines from your terminal until you give a line consisting of just a “.”, 
placing these lines after the current line. The last line you type then 
becomes the current line. The command insert (i) is like append 
but places the lines you give before, rather than after, the current 
line. 


Edit numbers the lines in the buffer, with the first line having number 
1. If you give the command “1” then edit will type this first line. If 
you then give the command delete edit will delete the first line, line 
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2 will become line 1, and edit will print the current line (the new line 
1) so you can see where you are. In general, the current line will 
always be the last line affected by a command. 


You can make a change to some text within the current line by 
using the substitute (s) command. You say ‘s/old/new/” where 
old is replaced by the old characters you want to get rid of and new 
is the new characters you want to replace it with. 


The command file (f) will tell you how many lines there are in the 
buffer you are editing and will say “[Modified]” if you have changed 
it. After modifying a file you can put the buffer text back to replace 
the file by giving a write (w) command. You can then leave the edi- 
tor by issuing a quit (q) command. If you run edit on a file, but do 
not change it, it is not necessary (but does no harm) to write the file 
back. If you try to quit from edit after modifying the buffer without 
writing it out, you will be warned that there has been “No write 
since last change” and edit will await another command. If you wish 
not to write the buffer out then you can issue another quit com- 
mand. The buffer is then irretrievably discarded, and you return to 
the shell. 


By using the delete and append commands, and giving line 
numbers to see lines in the file you can make any changes you 
desire. You should learn at least a few more things, however, if you 
are to use edit more than a few times. 


The change (c) command will change the current line to a 
sequence of lines you supply (as in append you give lines up to a 
line consisting of only a “.”). You can tell change to change more 
than one line by giving the line numbers of the lines you want to 
change, i.e., “3,5change”. You can print lines this way too. Thus 
“1,23p" prints the first 23 lines of the file. 


The undo (u) command will reverse the effect of the last command 
you gave which changed the buffer. Thus if you give a substitute 
command which does not do what you want, you can say undo and 
the old contents of the line will be restored. You can also undo an 
undo command so that you can continue to change your mind. Edit 
will give you a warning message when commands you do affect 
more than one line of the buffer. If the amount of change seems 
unreasonable, you should consider doing an undo and looking to 
see what happened. If you decide that the change is ok, then you 
can undo again to get it back. Note that commands such as write 
and quit cannot be undone. 


To look at the next line in the buffer you can just hit carriage return. 
To look at a number of lines hit ‘D (control key and, while it is held 
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down D key, then let up both) rather than carriage return. This will 
show you a half screen of lines on a CRT or 12 lines on a hardcopy 
terminal. You can look at the text around where you are by giving 
the command “z.”. The current line will then be the last line printed; 
you can get back to the line where you were before the “z.” com- 
mand by saying ““"’. The z command can also be given other fol- 
lowing characters “z—" prints a screen of text (or 24 lines) ending 
where you are; “z+” prints the next screenful. If you want less than 
a screenful of lines, type in "z.12" to get 12 lines total. This method 
of giving counts works in general; thus you can delete 5 lines start- 
ing with the current line with the command “delete 5”. 


To find things in the file, you can use line numbers if you happen to 
know them; since the line numbers change when you insert and 
delete lines this is somewhat unreliable. You can search backwards 
and forwards in the file for strings by giving commands of the form 
/text/ to search forward for text or ?text? to search backward for 
text. If a search reaches the end of the file without finding the text it 
wraps, end around, and continues to search back to the line where 
you are. A useful feature here is a search of the form /‘text’ which 
searches for text at the beginning of a line. Similarly /text$/ 
searches for text at the end of a line. You can leave off the trailing / 
or ? in these commands. 


The current line has a symbolic name “.”; this is most useful in a 
range of lines as in “.,$print” which prints the rest of the lines in the 
file. To get to the last line in the file you can refer to it by its sym- 
bolic name “$”. Thus the command “$ delete” or “$d” deletes the 
last line in the file, no matter which line was the current line before. 
Arithmetic with line references is also possible. Thus the line “$—5”" 
is the fifth before the last, and “.+20” is 20 lines after the present. 


You can find out which line you are at by doing “.=". This is useful 
if you wish to move or copy a section of text within a file or between 
files. Find out the first and last line numbers you wish to copy or 
move (say 10 to 20). For a move you can then say “10,20delete a” 
which deletes these lines from the file and places them in a buffer 
named a. Edit has 26 such buffers named a through z. You can 


later get these lines back by doing “put a” to put the contents of 


buffer a after the current line. If you want to move or copy these 
lines between files you can give an edit (e) command after copying 
the lines, following it with the name of the other file you wish to edit, 
i.e., “edit chapter2”. By changing delete to yank above you can get 
a pattern for copying lines. If the text you wish to move or copy is 
all within one file then you can just say “10,20move $” for example. 
It is not necessary to use named buffers in this case (but you can if 
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SEE ALSO 
ex(1), vi(1). 
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NAME 7 
efl — Extended Fortran Language 


SYNOPSIS 
efl [ options | [ files ] 


DESCRIPTION 
Eff compiles a program written in the EFL language into clean For- 
tran on the standard output. Eff provides the C-like control con- 
structs of ratfor (1): 


statement grouping with braces. 


decision-making: 
if , if - else , and select - case (also known as 
switch - case ); 
while , for , Fortran do , repeat , and repeat ... 
until loops; 
multi-level break and next. 


EFL has C-like data structures, e.g.: 
struct 


{ 

integer flags(3) 
character(8) name 
long real coords(2) 
} table(100) 


The language offers generic functions, assignment operators (+ =, 
&= , etc.), and sequentially evaluated logical operators (&& and || 
). There is a uniform input/output syntax: 


write(6,x,y:f(7,2), do i=1,10 { af(i,j),z-0(i) }) 
EFL also provides some syntactic “sugar”: 


free-form input: | 
multiple statements per line; automatic continuation; 
statement label names (not just numbers). 


comments: 
# this is a comment. 


translation of relational and logical operators: 
>,>=,é&,etc., become .GT. , .GE. , .AND. , etc. 


return expression to caller from function: 
return (expression) 
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mo defines: 
( define name replacement 


includes: 
include file 


Eff understands several option arguments: —w suppresses warning 
messages, —# suppresses comments in the generated program, 
and the default option -C causes comments to be included in the 
generated program. 


An argument with an embedded - (equal sign) sets an EFL option 
as if it had appeared in an option statement at the start of the pro- 
gram. Many options are described in the reference manual. A set 
of defaults for a particular target machine may be selected by one of 
the choices: system- unix , system gcos , or system=-cray . 
The default setting of the system option is the same as the machine 
the compiler is running on. Other specific options determine the 
style of input/output, error handling, continuation conventions, the 
number of characters packed per word, and default formats. 


Efl is best used with f77 (7). 


SEE ALSO 
( | cc(1), f77(1), ratfor(1). 
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NAME 
enable, disable — enable/disable LP printers 


SYNOPSIS 
enable printers 
disable [-—c] [-r[reason]] printers 


DESCRIPTION 
Enable activates the named printers , enabling them to print 
requests taken by /p (1). Use Ipstat (7) to find the status of printers. 


Disable deactivates the named printers , disabling them from print- 
ing requests taken by /p (1). By default, any requests that are 
currently printing on the designated printers will be reprinted in their 
entirety either on the same printer or on another member of the 
same class. Use /pstat (1) to find the status of printers. Options 
useful with disable are: 


—C Cancel any requests that are currently printing on any 
of the designated printers. 


-f [reason] Associates a reason with the deactivation of the 
printers. This reason applies to all printers mentioned 
up to the next -r option. If the -r option is not present 
or the -r option is given without a reason, then a 
default reason will be used. Reason is reported by 
Ipstat (1). 


FILES 
/ust/Spool/lp/* 


SEE ALSO 
Ip(1), Ipstat(1). 
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NAME 

env — set environment for command execution 
SYNOPSIS 

env [-] [ name=value ] .... [ command args ] 
DESCRIPTION 


Env obtains the current environment , modifies it according to its 
arguments, then executes the command with the modified environ- 
ment. Arguments of the form name =value are merged into the 
inherited environment before the command is executed. The — flag 
causes the inherited environment to be ignored completely, so that 
the command is executed with exactly the environment specified by 
the arguments. 


lf no command is specified, the resulting environment is printed, one 
name-value pair per line. 


SEE ALSO 
sh(1). 
exec(2), profile(4), environ(5) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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eqn, neqn, checkeq — format mathematical text for nroff or troff 


SYNOPSIS 


eqn [ -—dxy ] [ -pn ] [ -sn ] [ -fn ] [ —Tdest ] [ files ] 
neqn [ —dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
checkeg [ files ] 


DESCRIPTION 
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Eqn is a troff(1) preprocessor for typesetting mathematical text on a 
phototypesetter, while neqn is used for the same purpose with nroff 
on typewriter-like terminals. Usage is almost always: 


eqn files | troff 
neqn files | nroff 


or equivalent. If no files are specified (or if — is specified as the last 
argument), these programs read the standard input. Eqn prepares 
output for the typesetter named in the —T option. Currently sup- 
ported devices are —Taps (Autologic APS-5), -TX97 (Xerox 9700), 
-Ti10 (Imagen Imprint-10), and —Tcat (Wang CAT). Default is 
~—Taps. 


A line beginning with .EQ marks the start of an equation; the end of 
an equation is marked by a line beginning with .EN. Neither of these 
lines is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to designate two char- 
acters as delimiters; subsequent text between delimiters is then 
treated as eqn input. Delimiters may be set to characters x and y 
with the command-line argument —dxy or (more commonly) with 
delim xy between .EQ and .EN. The left and right delimiters may be 
the same character; the dollar sign is often used as such a delimiter. 
Delimiters are turned off by delim off. All text that is neither 
between delimiters nor between .EQ and .EN is passed through 
untouched. 


The program checkeq reports missing or unbalanced delimiters and 
-EQ/.EN pairs. 


Tokens within eqn are separated by spaces, tabs, new-lines, 
braces, double quotes, tildes, and circumflexes. Braces {} are used 
for grouping; generally speaking, anywhere a single character such 
as x could appear, a complicated construction enclosed in braces 
may be used instead. Tilde (~) represents a full space in the output, 
circumflex (*) half as much. 


Subscripts and superscripts are produced with the keywords sub 

; 2 

and sup. Thus x sub j makes x;, a Sub k sup 2 produces a,, 

while e“ '” is made with "e sup {x sup 2 + y sup 2}". Fractions 
a 

are made with over: a over b yields —; sqrt makes square roots: 
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1 over sqrt {ax sup 2+6x+c} results in 


Vax’+bx+e 
n 


The keywords from and to introduce lower and upper limits: lim S x, 
n-~x 
is made with lim from {n —> inf} sum from 0 ton x subi. Left 
and right brackets, braces, etc., of the right height are made with 
left and right: /eft [ x sup 2 + y sup 2 over alpha right ] ~=~ 1 
2 


produces pee = 1. Legal characters after left and right are 
Q 

braces, brackets, bars, c and f for ceiling and floor, and "" for noth- 

ing at all (useful for a right-side-only bracket). A left thing need not 

have a matching right thing. 


Vertical piles of things are made with pile, Ipile, cpile, and rpile: 
a 
pile {a above b above c} produces b. Piles may have arbitrary 


C 
numbers of elements; [pile left-justifies, pile and cpile center (but 
with different vertical spacing), and rpile right justifies. Matrices are 
made with matrix: matrix { [col { x sub i above y sub 2 } ccol { 1 

i 
above 2 } } produces ae In addition, there is rcol for a right- 


2 
justified column. 


Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, 
dyad, and under: x dot =( int ) (t) bar yields x=({)(), 
y dotdot bar~=-nunder is y =n, and x vec ~=- y dyad is 
X=y. 

Point sizes and fonts can be changed with size n or size +n, 
roman, italic, bold, and font nm. Point sizes and fonts can be 


changed globally in a document by gsize n and gfont 7, or by the 
command-line arguments —sn and —fn. 


Normally, subscripts and superscripts are reduced by 3 points from 
the previous size; this may be changed by the command-line argu- 
ment —pn. 


Successive display arguments can be lined up. Place mark before 
the desired lineup point in the first equation; place lineup at the 
place that is to line up vertically in subsequent equations. 


Shorthands may be defined or existing keywords redefined with 
define: 


define thing % replacement % 
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defines a new token called thing that will be replaced by replace- 
ment whenever it appears thereafter. The % may be any character 
that does not occur in replacement. 


Keywords such as sum (>), int ( f ), inf (%), and shorthands such 
as >= (=), != (A), and —> (-) are recognized. Greek letters are 
spelled out in the desired case, as in alpha (a), or GAMMA (T). 
Mathematical words such as sin, cos, and log are made Roman 
automatically. Troff(1) four-character escapes such as \(dd (+) and 
\(sc (§) may be used anywhere. Strings enclosed in double quotes 
("...") are passed through untouched; this permits keywords to be 
entered as text, and can be used to communicate with troff(1) when 
all else fails. Full details are given in the manual cited below. 


SEE ALSO 
mm(1), mmt(1), nroff(1), tbl(1), troff(1), eqnchar(5), mm(5), mv(5). 


Typesetting Mathematics—User Guide by B. W. Kernighan and L. L. 
Cherry. 


BUGS 
To embolden digits, parentheses, etc., it is necessary to quote 
them, as in bold "12.3". 
See also BUGS under troff(1). 
Some things do not work correctly. Diacritical marks are too close 
to the letters they should be above and the matrix columns use too 
much space (see examples on preceding page). There may be 
other problems. For some things the Sys3 version of eqn may work 
better. 
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ex — text editor 


SYNOPSIS 


ex [-][{-—-v][ + tag ] [ +] [ -R ] [ tcommand | [-! ] [ 
-x |] name ... 


DESCRIPTION 


Ex is the root of a family of editors: ex and vi. Ex is a superset of 
ed, with the most notable extension being a display editing facility. 
Display based editing is the focus of vi. 


If you have a CAT terminal, you may wish to use a display based 
editor; in this case see vi (7), which is a command which focuses 
on the display editing portion of ex. 


DOCUMENTATION 


The Ex Reference Manual is a comprehensive and complete 
manual for the command mode features of ex, but you cannot learn 
to use the editor by reading it. For an introduction to more 
advanced forms of editing using the command mode of ex see the 
editing documents written by Brian Kernighan for the editor ed; the 
material in the introductory and advanced documents works also 
with ex. 


An Introduction to Display Editing with Vi introduces the display 
editor vi and provides reference material on vi. The Vi Quick Refer- 
ence card summarizes the commands of wi in a useful, functional 
way, and is useful with the /ntroduction. The vi(1) manual page can 
also be used as reference. 


FOR ED USERS 
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If you have used ed you will find that ex has a number of new 
features useful on CRT terminals. Intelligent terminals and high 
speed terminals are very pleasant to use with v/. Generally, the edi- 
tor uses far more of the capabilities of terminals than ed does, and 
uses the terminal capability data base terminfo (4) and the type of 
the terminal you are using from the variable TERM in the environ- 
ment to determine how to drive your terminal efficiently. The editor 
makes use of features such as insert and delete character and line 
in its visual command (which can be abbreviated vi) and which is 
the central mode of editing when using vi (7). 


Ex contains a number of new features for easily viewing the text of 
the file. The z command gives easy access to windows of text. Hit- 
ting “D causes the editor to scroll a half-window of text and is more 
useful for quickly stepping through a file than just hitting return. Of 
course, the screen-oriented visual mode gives constant access to 
editing context. 
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Ex gives you more help when you make mistakes. The undo (u) 
command allows you to reverse any single change which goes 
astray. Ex gives you a lot of feedback, normally printing changed 
lines, and indicates when more than a few lines are affected by a 
command so that it is easy to detect when a command has affected 
more lines than it should have. 


The editor also normally prevents overwriting existing files unless 
you edited them so that you do not accidentally clobber with a write 
a file other than the one you are editing. If the system (or editor) 
crashes, or you accidentally hang up the phone, you can use the 
editor recover command to retrieve your work. This will get you 
back to within a few lines of where you left off. 


Ex has several features for dealing with more than one file at a 
time. You can give it a list of files on the command line and use the 
next (n) command to deal with each in turn. The next command 
can also be given a list of file names, or a pattern as used by the 
shell to specify a new set of files to be dealt with. In general, 
filenames in the editor may be formed with full shell metasyntax. 
The metacharacter ‘%’ is also available in forming filenames and is 
replaced by the name of the current file. 


For moving text between files and within a file the editor has a group 
of buffers, named a through z. You can place text in these named 
buffers and carry it over when you edit another file. 


There is a command & in ex which repeats the last substitute com- 
mand. In addition there is a confirmed substitute command. You 
give a range of substitutions to be done and the editor interactively 
asks whether each substitution is desired. 


It is possible to ignore case of letters in searches and substitutions. 
Ex also allows regular expressions which match words to be con- 
structed. This is convenient, for example, in searching for the word 
“edit” if your document also contains the word “editor.” 


Ex has a set of options which you can set to tailor it to your liking. 
One option which is very useful is the autoindent option which 
allows the editor to automatically supply leading white space to align 
text. You can then use the “D key as a backtab and space and tab 
forward to align new code easily. 


Miscellaneous new useful features include an intelligent join (j) 
command which supplies white space between joined lines automat- 
ically, commands < and > which shift groups of lines, and the abil- 
ity to filter portions of the buffer through commands such as sort. 


INVOCATION OPTIONS 


The following invocation options are interpreted by ex : 
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—-R 


+command 


—X 
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Suppress all interactive-user feedback. This is 
useful in processing editor scripts. 


Invokes vi 


Edit the file containing the tag and position the edi- 
tor at its definition. 


Recover file after an editor or system crash. If file 
is not specified a list of all saved files will be 
printed. 


Readonly mode set, prevents accidentally overwrit- 
ing the file. 

Begin editing by executing the specified editor 
search or positioning command. 

LISP mode; indents appropriately for lisp code, the 


() {} [[ and ]] commands in vi are modified to have 
meaning for /isp . 


Encryption mode; a key is prompted for allowing 
creation or editing of an encrypted file. 


The name argument indicates files to be edited. 


Ex States 


Command 


Insert 


Visual 


Normal and initial state. Input prompted for by :. 
Your kill character cancels partial command. 


Entered by a i and c. Arbitrary text may be 
entered. Insert is normally terminated by line hav- 
ing only . on it, or abnormally with an interrupt. 


Entered by vi, terminates with Q or ’\. 


Ex command names and abbreviations 


abbrev 
append 
args 
change 
copy 
delete 
edit 

file 
global 
insert 
join 

list 
map 
mark 
move 
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next n unabbrev una 
number nu undo u 
unmap unm 
preserve pre version ve 
print p visual vi 
put pu write Ww 
quit q xit X 
read re yank ya 
recover rec window Zz 
rewind rew escape ! 
set se Ishift < 
shell sh print next CR 
source so resubst & 
stop st rshift > 
substitute $s scroll “D 
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n line n [pat next with pat 
: current ?pat previous with pat 
$ last x-n n before x ee 
+ next X,Y x through y 
_ previous x marked with x 
+n n forward a previous context 
%o 1,$ 
Initializing options 
EXINIT place set's here in environment var. 


$HOME/.exre editor initialization file 
./,@xrc editor initialization fie 
set x enable option 

set nox disable option 

give value vai 

set show changed options 
set all show all options 

set x? show value of option x 


Most useful options 


autoindent al supply indent 

autowrite aw write before changing files 

ignorecase IC In scanning we 
lisp () { } are s-exp’s : 
list print ‘| for tab, $ at end — 
magic . [ * special in patterns 

number nu number lines 

paragraphs para macro names wnicnh start ... 

redraw simulate smart terminal 

scroll command meade lines 

sections sect macro names ... 

shiftwidth SW for < >, and input “D 

showmatch sm to ) and } as typed 

showmode smd show insert mode in vi 

slowopen slow stop updates during insert 

window visual mode lines 

wrapscan ws around end of buffer? 

wrapmargin wm automatic line splitting 


$ 
\< 
\> 


[str] 
[tstr] 
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Scanning pattern formation 


beginning of line 
end of line 

any character 
beginning of word 
end of word 

any char in str 

... NOt in str 
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[x—y] ... between x and y 
: any number of preceding 


( AUTHOR 
- Vi and ex are based on software developed by The University of 


California, Berkeley California, Computer Science Division, Depart- 
ment of Electrical Engineering and Computer Science. 


FILES 
/usr/lib/ex?. ?strings error messages 
/usr/lib/ex?. ?recover recover command 
/usr/lib/ex?.? preserve preserve command 
/usr/lib/*/* describes capabilities of terminals 
$HOME/.exrc editor startup file 
/.XtC editor startup file 
/tmp/Exnnannn editor temporary 
/tmp/Rxnannn named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 


awk(1), ed(1), edit(1), grep(1), sed(1), vi(1). 
curses(3X), term(4), terminfo(4) in the Sys5 UNIX Programmer 
Reference Manual. 


CAVEATS AND BUGS | 
( The undo command causes all marks to be lost on lines changed 
: and then restored if the marked lines were changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical 
lines. More than a screen full of output may result if long lines are 
present. 


File input/output errors do not print a name if the command line ‘’ 
option is used. 


There is no easy way to do a single scan ignoring case. 


The editor does not warn if text is placed in named buffers and not 
used before exiting the editor. 


Null characters are discarded in input files and cannot appear in 
resultant files. 
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NAME 


expr — evaluate arguments as an expression 


SYNOPSIS 


expr argu ments 


DESCRIPTION 
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The arguments are taken as an expression. After evaluation, the 
result is written on the standard output. Terms of the expression 
must be separated by blanks. Characters special to the shell must 
be escaped. Note that 0 is returned to indicate a zero value, rather 
than the null string. Strings containing blanks or other special char- 
acters should be quoted. Integer-valued arguments may be pre- 
ceded by a unary minus sign. Internally, integers are treated as 
32-bit, 2s complement numbers. 


The operators and keywords are listed below. Characters that need 
to be escaped are preceded by \. The list is in order of increasing 
precedence, with equal precedence operators grouped within {} 
symbols. 


expr \| expr 
returns the first expr if it is neither null nor 0, otherwise 
returns the second expr. 


expr \& expr 
returns the first expr if neither expr is null or 0, otherwise 
returns 0. 


expr { =, \>,\>=,\<,\<=, != } expr 
returns the result of an integer comparison if both argu- 
ments are integers, otherwise returns the result of a lexical 
comparison. 


expr { +, —-—} expr 
addition or subtraction of integer-valued arguments. 


expr {\*, /, %} expr 
multiplication, division, or remainder of the integer-valued 
arguments. 


expr : expr 
The matching operator : compares the first argument with 
the second argument which must be a regular expression. 
Regular expression syntax is the same as that of ed (7), 
except that all patterns are “anchored” (i.e., begin with *) 
and, therefore, ~ is not a special character, in that context. 
Normally, the matching operator returns the number of char- 
acters matched (0 on failure). Alternatively, the \(...\) 
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pattern symbols can be used to return a portion of the first 


argument. 
EXAMPLES 
1. a=*expr $a + 1° 
adds 1 to the shell variable a. 
2. # For $a equal to either "/usr/abc/file” or just "file" ’ 
expr $a : ~.*/(.*\)* \| $a 
returns the last segment of a path name (i.e., file). 
Watch out for / alone as an argument: expr will take 
it as the division operator (see BUGS below). 
3. # A better representation of example 2. 


expr //$a : 7.*/\(.*\) ¢ 


The addition of the // characters eliminates any 
ambiguity about the division operator and simplifies 
the whole expression. 


4. expr $VAR : 7.*” 


returns the number of characters in $SVAR. 


| SEE ALSO 
ed(1), sh(1). 
EXIT CODE 
As a side effect of expression evaluation, expr returns the following 
exit values: 
0 if the expression is neither null nor 0 
1 if the expression /s null or 0 
2 _ for invalid expressions. 
DIAGNOSTICS 
syntax error for operator/operand errors 
non-numeric argument if arithmetic is attempted on such a string 
BUGS 


After argument processing by the shell, expr cannot tell the differ- 
ence between an operator and an operand except by the value. If 
$a is an = , the command: 


expr $a = ‘=’ 
looks like: 
expr = = = 


as the arguments are passed to expr (and they will all be taken as 
the = operator). The following works: 


expr X$a = X= 
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NAME 
ons f77 — Fortran 77 compiler 


(_ SYNOPSIS 


f77 [ options | files 


DESCRIPTION 
F77 is the UNIX System Fortran 77 compiler; it accepts several 
types of file arguments: 


Arguments whose names end with .f are taken to be Fortran 
77 source programs; they are compiled and each object 
program is left in the current directory in a file whose name 
is that of the source, with .o substituted for .f . 


Arguments whose names end with .r or .e are taken to be 
RATFOR or EFL source programs, respectively. These are 
first transformed by the appropriate preprocessor, then com- 
piled by f77 , producing .o files. 


In the same way, arguments whose names end with .c or .s 
are taken to be C or assembly source programs and are 
compiled or assembled, producing .o files. 


The following options have the same meaning as in cc (7) (see /d 
(7) for link editor options): 


—Cc Suppress link editing and produce .o files for each 
source file. 

—p Prepare object files for profiling (see prof (7)). 

—O Invoke an object-code optimizer. 

-S Compile the named programs and leave the 


assembler-language output in corresponding files 
whose names are suffixed with .s . (No .o files are 


created.) 
—ooutput Name the final output file output , instead of a.out . 
—f IN systems without floating-point hardware, use a ver- 


sion of f77 that handles floating-point constants and 
links the object program with the floating-point inter- 
preter. 


The following options are peculiar to f77 : 


—onetrip Compile DO loops that are performed at least once if 
reached. (Fortran 77 DO loops are not performed at 
all if the upper limit is smaller than the lower limit.) 


—1 Same as —onetrip . 
—66 Suppress extensions which enhance Fortran 66 com- 
a patibility. 
( -C Generate code for run-time subscript range-checking. 
| —U Do not "fold" cases. F77 is normally a no-case 


| language (i.e., a is equal to A ). The —U option causes 
Page 1 September 29, 1986 


F77(1) UNIX Sys5 (not supported) F77(1) 


f77 to treat upper and lower cases to be separate. 


—u Make the default type of a variable undefined , rather | 
than using the default Fortran rules. —_— 

-V Verbose mode. Provide diagnostics for each process <_ / 
during compilation. 

—W Suppress all warning messages. If the option is -w66 
, only Fortran 66 compatibility warnings are 
suppressed. 

—F Apply EFL and RATFOR preprocessor to relevant files, 


put the result in files whose names have their suffix | 

changed to .f . (No .o files are created.) | 
—m Apply the M4 preprocessor to each EFL or RATFOR | 

source file before transforming with the ratfor (7) or eff 

(1) processors. 


—E The remaining characters in the argument are used as 
an EFL flag argument whenever processing a .e file. 
—R The remaining characters in the argument are used as 


a RATFOR flag argument whenever processing a .r file. 


Other arguments are taken to be either link-editor option arguments 
or (77 -compilable object programs (typically produced by an earlier 
run), or libraries of f77 -compilable routines. These programs, 
together with the results of any compilations specified, are linked (in 


the order given) to produce an executable program with the default ~ 
name a.out . — 
FILES 
file.[fresc] input file 
file.o object file 
a.out linked output 
./fort[|pid].? temporary 
/usr/lib/f77pass1 compiler 
/usr/lib/f77pass2 pass 2 
/lib/c2 optional optimizer 
/usr/lib/libF77.a intrinsic function library 
/usr/lib/lib|77.a Fortran I/O library 
/lib/ibe.a C library; see Section 3 of this Manual. 
SEE ALSO 
asa(1), cc(1), efl(1), fsplit(1), Id(1), m4(1), prof(1), ratfor(1). 
DIAGNOSTICS . 


The diagnostics produced by f/7 itself are intended to be self- 
explanatory. Occasional messages may be produced by the link 
editor Id (1). 
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NAME 

factor — factor a number 
SYNOPSIS 

factor [ number | 
DESCRIPTION 


When factor is invoked without an argument, it waits for a number 
to be typed in. If you type in a positive number less than 2°° (about 
7.2xX 10'°) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another 
number. It exits if it encounters a zero or any non-numeric charac- 
ter. 


lf factor is invoked with an argument, it factors the number as above 
and then exits. 


Maximum time to factor is proportional to Vn and occurs when n is 
prime or the square of a prime. 


DIAGNOSTICS 
“Ouch” for input out of range or for garbage input. 
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NAME 
file — determine file type 


(_ SYNOPSIS 
: file [-c ][-f ffile ] [-—m mfile ] arg ... 


DESCRIPTION 
File performs a series of tests on each argument in an attempt to 
classify it. If an argument appears to be ASCII, file examines the 
first 512 bytes and tries to guess its language. If an argument is an 
executable a.out , file will print the version stamp, provided it is 
greater than O (see /d (7)). 


lf the —f option is given, the next argument is taken to be a file con- 
taining the names of the files to be examined. 


File uses the file /etc/magic to identify files that have some sort of 
magic number , that is, any file containing a numeric or string con- 
stant that indicates its type. Commentary at the beginning of 
/etc/magic explains its format. 

The —m option instructs fife to use an alternate magic file. 


The —c flag causes file to check the magic file for format errors. 
This validation is not normally carried out for reasons of efficiency. 

_ No file typing is done under -c . 
( ; SEE ALSO 
— Id(1).: 
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NAME 
find — find files 


SYNOPSIS 
find path-name-list expression 


DESCRIPTION 
Find recursively descends the directory hierarchy for each path 
name in the path-name-list (i.e., one or more path names) seeking 
files that match a boolean expression written in the primaries given 
below. In the descriptions, the argument n is used as a decimal 
integer where +n means more thann, —n means less thann andn 
means exactly n. 


—name file True if file matches the current file name. Normal 
shell argument syntax may be used if escaped 
(watch out for[, ? and +* ). 


-—inum # Will report on the file with the specified inode 
number. | | 
—perm onum True if the file permission flags exactly match the 


octal number onum (see chmod (7)). If onum is 
prefixed by a minus sign, more flag bits (017777, 
see stat (2)) become significant and the flags are 
compared. 


—type c True if the type of the file isc, wherec isb,c, 
d,p, or f for block special file, character special 
file, directory, fifo (a.k.a named pipe), or plain file 
respectively. 


—links n True if the file has n links. 


—user uname True if the file belongs to the user uname . lf 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 


—group gname True if the file belongs to the group gname . If 
gname is numeric and does not appear in the 
/etc/group file, it is taken as a group ID. 


-—size n[c ] True if the file is n blocks long (512 bytes per 
block). If n is followed by ac, the size is in char- 
acters. 

—atime n True if the file has been accessed inn days. The 


access time of directories in path-name-list is 
changed by find itself. 


—mtime n True if the file has been modified in n days. 
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—ctime n 


—exec cmd 


—ok cmd 


—print 
—cpio device 


—newer file 


—depth 


( expression ) 
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True if the file has been changed inn days. 


True if the executed cmd returns a zero value as 
exit status. The end of cmd must be punctuated 
by an escaped semicolon. A command argument 
{} is replaced by the current path name. 


Like —exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y . 


Always true; prints current path name. 


Always true; write the current file on device in 
cpio (4) format (5120-byte records). 


True if the current file has been modified more 
recently than the argument file . 


Always true; causes descent of the directory 
hierarchy to be done so that all entries in a direc- 
tory are acted on before the directory itself. This 
can be useful when find is used with cpio (71) to 
transfer files that are contained in directories 
without write permission. 


True if the parenthesized expression is true 
(parentheses must be escaped for the shell). 


The primaries may be combined using the following operators (in 
order of decreasing precedence): 


1) The negation of a primary (! is the unary not operator). 


2) Concatenation of primaries (the and operation is implied). 


3) Alternation of primaries (—o is the or operator). 


EXAMPLES 


Remove files named a.out or #.0 not opened for a week: 


find / \( —name a.out —o —name ’*.0’ \) -atime +7 —exec rm {}\; 


List all files except files beginning with the name l/oca/l: 


find /\( —name ’*' ! —name local’*’ \) —print 


FILES 


/etc/passwd, /etc/group 


SEE ALSO 


chmod(1), cpio(1), sh(1), test(1). 
stat(2), cpio(4), fs(4) in the Sys5 UNIX Prog. Ref. Manual. 
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NAME 
fsplit — split f77, ratfor, or efl files 

SYNOPSIS 
fsplit options files 

DESCRIPTION 
Fsplit splits the named file(s) into separate files, with one procedure 
per file. A procedure includes blockdata, function, main, program, 
and subroutine program segments. Procedure X is put in file X.f, 
X.r, or X.e depending on the language option chosen, with the fol- 
lowing exceptions: main is put in the file MAI/N.[efr] and unnamed 
blockdata segments in the files blockdataN.[efr] where N is a 
unique integer value for each file. 
The following options pertain: 
—f (default) Input files are f77. 
—r Input files are ratfor . 
-e Input files are Eff. 
-S Strip f77 input lines to 72 or fewer characters with trailing 

blanks removed. 
SEE ALSO 


csplit(1), efl(1), f77(1), ratfor(1), split(1). 
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hpd, erase, hardcopy, tekset, td — graphical device routines and 


filters 


SYNOPSIS 
hpd [—options] [GPS file ...] 
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erase 
hardcopy 
tekset 


td [-eurn] [GPS file ...] 


DESCRIPTION 
All of the commands described below reside in /usr/bin/graf (see 
graphics (1G)). 


hpd 


erase 


hardcopy 


Hpd translates a GPS (see gps (4)), to instructions for 
the Hewlett-Packard 7221A Graphics Plotter. A viewing 
window is computed from the maximum and minimum 
points in file unless the -u or -r option is provided. If no 
file is given, the standard input is assumed. Options 
are: 


cn Select character set n , n between O and 5 (see 
the "HP7221A Plotter Operating and Programming 
Manual" ", " "Appendix A" ). 


pn Select pen numbered n , n between 1 and 4 
inclusive. 


ro Window on GPS region n , n between 1 and 25 
inclusive. 


sn Slant characters n degrees clockwise from the 
vertical. 


u Window on the entire GPS universe. 


xdn Set x displacement of the viewport’s lower left 
corner ton inches. 


xvn_ Set width of viewport to n inches. 


ydn Set y displacement of the viewport’s lower left 
corner to n inches. 


yvn Set height of viewport to n inches. 


Erase sends characters to a TEKTRONIX 4010 series 
storage terminal to erase the screen. 


When issued at a TEKTRONIX display terminal with a 
hard copy unit, hardcopy generates a screen copy on 
the unit. 
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tekset Tekset sends characters to a TEKTRONIX terminal to 


clear the display screen, set the display mode to alpha, ~ > 
and set characters to the smallest font. ke. 
td Td translates a GPS to scope code for a TEKTRONIX 
4010 series storage terminal. A viewing window is com- 
puted from the maximum and minimum points in file 
unless the —u or -r option is provided. If no file is given, 
the standard input is assumed. Options are: 
e Do not erase screen before initiating display. 
rn Display GPS region n, n between 1 and 25 
inclusive. 
u Display the entire GPS universe. 
SEE ALSO 
ged(1G), graphics(1G). 
gps(4) in the UNIX System Programmer Reference Manual. 
a 
—_ 
ae 
MS ol 
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NAME 


ged — graphical editor 


SYNOPSIS 


ged [-euRrn] [GPS file ...] 


DESCRIPTION 


Ged is an interactive graphical editor used to display, construct, and 
edit GPS files on TEKTRONIX 4010 series display terminals. If GPS 
file(s) are given, ged reads them into an internal display buffer and 
displays the buffer. The GPS in the buffer can then be edited. If — 
is given as a file name, ged reads a GPS from the standard input. 


Ged accepts the following command line options: 
e Do not erase the screen before the initial display. 
rn Display region number n. 
u Display the entire GPS universe. 
R Restricted shell invoked on use of !. 


A GPS file is composed of instances of three graphical objects: 
lines, arc, and text. Arc and fines objects have a start point, or 
object-handle, followed by zero or more points, or point-handles. 
Text has only an object-handle. The objects are positioned within a 
Cartesian plane, or universe, having 64K (—32K to +32K) points, or 
universe-units, on each axis. The universe is divided into 25 equal 
sized areas called regions. Regions are arranged in five rows of 
five squares each, numbered 1 to 25 from the lower left of the 
universe to the upper right. 


Ged maps rectangular areas, called windows, from the universe 
onto the display screen. Windows allow the user to view pictures 
from different locations and at different magnifications. The 
universe-window is the window with minimum magnification, i.e., the 
window that views the entire universe. The home-window is the 
window that completely displays the contents of the display buffer. 


COMMANDS 
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Ged commands are entered in stages . Typically each stage ends 
with a <cr> (return). Prior to the final <cr> the command may be 
aborted by typing rubout. The input of a stage may be edited dur- 
ing the stage using the erase and kill characters of the calling shell. 
The prompt * indicates that ged is waiting at stage 1. 


Each command consists of a subset of the following stages: 
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1. Command line 


2. Text 
3. Points 
4. Pivot 


A command line consists of a command name fol- 
lowed by argument(s) followed by a <cr>. A com- 
mand name is a single character. Command argu- 
ments are either option(s) or a file-name. Options are 
indicated by a leading -. 


Text is a sequence of characters terminated by an 
unescaped <cr>. (120 lines of text maximum.) 


Points is a sequence of one or more screen locations 
(maximum of 30) indicated either by the terminal 
crosshairs or by name. The prompt for entering points 
is the appearance of the crosshairs. When the 
crosshairs are visible, typing: 


Sp (space) enters the current location as a point. 
The point is identified with a number. 


$n enters the previous point numbered n. 


>x labels the last point entered with the upper case 
letter x. 


$x enters the point labeled x. 


establishes the previous points as the current 
points. At the start of a command the previous 
points are those locations given with the previ- 
ous command. 


= echoes the current points. 


$.9 enters the point numbered n from the previous 
points. 


# erases the last point entered. 
@ _ erases all of the points entered. 


The pivot is a single location, entered by typing <cr> 
or by using the $ operator, and indicated with a «. 


5. Destination 


The destination is a single location entered by typing 
<cr> or by using $. 


COMMAND SUMMARY 
In the summary, characters typed by the user are printed in bold. 
Command stages are printed in italics. Arguments surrounded by 
brackets “[]” are optional. Parentheses ‘“()” surrounding arguments 
separated by ‘or’ means that one of the arguments must be given. 
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Construct commands: 


Arc [-echo,style,weight] points 
Box [—echo,style,weight] points 
Circle [—echo,style,weight] points 


Hardware —_ [-echo] text points 
Lines [-echo,style,weight] points 


Text —angle,echo, height, mid-point, right- 


[ 
point,text,weight] text points 


Edit commands: 


Delete ( — (universe or view) or points ) 

Edit [-angle,echo, height, style, weight] ( — (universe or 
view) or points ) 

Kopy [—echo, points, x] points pivot destination 

Move [—echo, points,x] points pivot destination 

Rotate [-angle,echo,kopy,x] points pivot destination 

Scale [(-echo,factor,kopy,x] points pivot destination 


View commands: 
coordinates points 


erase 
new-display 
object-handles __( — (universe or view) or points ) 


point-handles ( — (labelled-points or universe or view) or 


points ) 

view ( — (home or universe or region) or [-x] 
pivot destination ) 

x [—view] points 

zoom [—out] points 


Other commands: 
quit or Quit 
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set 


write 


lcommand 
? 


Options: 
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[—angle,echo, height, mid-point, right- 
point,text,weight 

file-name [destination] 
[-angle,echo, factor height,kopy,mid-point, points, 
right-point, style, text, weight, x] 


file-name 


Options specify parameters used to construct, edit, and view graphi- 
cal objects. If a parameter used by a command is not specifed as 


an option, the default value for the parameter will be used (see set — 


below). The format of command options is: 

—option |,option | 
where option is keyletter[value|. Flags take on the va/ues of true or 
false indicated by + and — respectively. If no va/ue is given with a 
flag, true is assumed. 


Object options: 
anglen 
echo 
factorn 
heightn 
kopy 
mid-point 


points 


right-point 


styletype 


text 
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Angle of n degrees. 

When true, echo additions to the display buffer. 
Scale factor is n percent. 

Height of text is n universe-units (0=n< 1280). 
When true, copy rather than move. 

When true, mid-point is used to locate text string. 


When true, operate on points otherwise operate 
on objects. 


When true, right-point is used to locate text 
string. 


Line style set to one of following types: 


sO solid 
da dashed 
dd dot-dashed 
do dotted 
Id long-dashed 


When false, fext strings are outlined rather than 
drawn. 
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weighttype Sets line weight to one of following types: 


Area options: 


n narrow 
m medium 
b bold 
home Reference the home-window. 
out Reduce magnification. 
regionn Reference region n. 
universe Reference the universe-window. 
view Reference those objects currently in view. 
Xx Indicate the center of the referenced area. 


COMMAND DESCRIPTIONS 
Construct commands: 
Arc and Lines 


behave similarly. Each consists of a command line followed 
by points . The first point entered is the object-handle. Suc- 
cessive points are point-handles. Lines connect the handles 
in numerical order. Arc fits a curve to the handles (currently a 
maximum of 3 points will be fit with a circular arc; splines will 
be added in a later version). | 


Box and Circle 


are special cases of Lines and Arc, respectively. Box gen- 
erates a rectangle with sides parallel to the universe axes. A 
diagonal of the rectangle would connect the first point entered 
with the last point. The first point is the object-handle. Point- 
handles are created at each of the vertices. Circle generates 
a circular arc centered about the point numbered zero and 
passing through the last point. The circle’s object-handle coin- 
cides with the last point. A point-handle is generated 180 
degrees around the circle from the object-handle. 


Text and Hardware 
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generate text objects. Each consists of a command line , text 
and points . Text is a sequence of characters delimited by 
<cr>. Multiple lines of text may be entered by preceding a cr 
with a backslash (i.e., \er). The Text command creates 
software generated characters. Each line of software text is 
treated as a separate text object. The first point entered is 
the object-handle for the first line of text. The Hardware com- 
mand sends the characters in text uninterpreted to the termi- 
nal. 
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Edit commands: | 

Edit commands operate on portions of the display buffer called 
defined areas. A defined area is referenced either with an area 
option or interactively. If an area option is not given, the perimeter 
of the defined area is indicated by points. If no point is entered, a 
small defined area is built around the location of the <er>. This is 
useful to reference a single point. If only one point is entered, the 
location of the <cr> is taken in conjunction with the point to indi- 
cate a diagonal of a rectangle. A defined area referenced by points 
will be outlined with dotted lines. 


Delete 
removes all objects whose object-handle lies within a defined 
area. The universe option removes all objects and erases the 
screen. 


Edit modifies the parameters of the objects within a defined area. 
Parameters that can be edited are: 
angle angle of fext 
height height of fext 
style — style of lines and arc 
weight weight of lines, arc, and text. 


Kopy (or Move) 
copies (or moves) object- and/or point-handles within a defined 
area by the displacement from the pivot to the destination. 


Rotate 
rotates objects within a defined area around the pivot. If the 
kopy flag is true then the objects are copied rather than 
moved. 


Scale 
For objects whose object handles are within a defined area, 
point dispiacements from the pivot are scaled by factor per- 
cent. If the kopy flag is true then the objects are copied rather 
than moved. 


View commands: 
coordinates 
prints the location of point(s) in universe- and screen-units. 


erase 
clears the screen (but not the display buffer). 


new-display 
erases the screen then displays the display buffer. 
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object-handles (or point-handles) 
labels object-handles (andor point-handles) that lie within the 
defined area with O (or P). Point-handles identifies labeled 
points when the labelled-points flag is true. 


view moves the window so that the universe point corresponding to 
the pivot coincides with the screen point corresponding to the 
destination. Options for home, universe, and region display 
particular windows in the universe. 


x indicates the center of a defined area. Option view indicates 
the center of the screen. 


zoom 
decreases (zoom out) or increases the magnification of the 
viewing window based on the defined area. For increased 
magnification, the window is set to circumscribe the defined 
area. For a decrease in magnification the current window is 
inscribed within the defined area. 


Other commands: 


quit or Quit 
exit from ged. Quit responds with ? if the display buffer has 
not been written since the last modification. 


read inputs the contents of a file. If the file contains a GPS it Is 
read directly. If the file contains text it is converted into text 
object(s). The first line of a text file begins at destination. 


set when given option(s) resets default parameters, otherwise it 
prints current default values. 


write outputs the contents of the display buffer to a file. 
! escapes ged to execute a UNIX system command. 
o lists ged commands. 


SEE ALSO 


gdev(1G), graphics(1G), sh(1). 
gps(4) in the Sys5 UNIX Programmer Manual. 


An Introduction to the Graphical Editor in the Sys5 UNIX Graphics 
Guide . | 


WARNING 
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See Appendix A of the TEKTRONIX 4014 Computer Display Terminal 
User’s Manual for the proper terminal strap options. 
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get — get a version of an SCCS file 


SYNOPSIS 


get [-rSID] [-ccutoff] [-ilist] [—xlist] [-wstring] [-aseq-no.] [—k] 
[-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] file ... 


DESCRIPTION 
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Get generates an ASCII text file from each named SCCS file accord- 
ing to the specifications given by its keyletter arguments, which 
begin with -. The arguments may be specified in any order, but all 
keyletter arguments apply to all named SCCS files. If a directory is 
named, get behaves as though each file in the directory were speci- 
fied as a named file, except that non-SCCS files (last component of 
the path name does not begin with s. ) and unreadable files are 
silently ignored. If a name of —- is given, the standard input is read; 
each line of the standard input is taken to be the name of an SCCS 
file to be processed. Again, non-SCCS files and unreadable files are 
silently ignored. 


The generated text is normally written into a file called the g-file 
whose name is derived from the SCCS file name by simply removing 
the leading s. ; (see also FILES, below). 


Each of the keyletter arguments is explained below as though only 
one SCCS file is to be processed, but the effects of any keyletter 
argument applies independently to each named file. 


—rS/D The S CCS I/D entification string (SID) of the version 
(delta) of an SCCS file to be retrieved. Table 1 below 
shows, for the most useful cases, what version of an 
SCCS file is retrieved (as well as the SID of the version to 
be eventually created by delta (7) if the -e keyletter is 
also used), as a function of the SID specified. 


-—ccutoff Cutoff date-time, in the form: 
YY[MM[DD[HH[MM[SS]}]]] 


No changes (deltas) to the SCCS file which were created 
after the specified cutoff date-time are included in the 
generated ASCII text file. Units omitted from the date- 
time default to their maximum possible values; that is, 
—c7502 is equivalent to -c750228235959 . Any number 
of non-numeric characters may separate the various 2- 
digit pieces of the cufoff date-time. This feature allows 
one to specify a cutoff date in the form: "-¢e77/2/2 
9:22:25". Note that this implies that one may use the 
%E% and %U% identification keywords (see below) for 
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nested gets within, say the input to a send (1C) com- 
mand: 


‘Iget "“—Cc%E% %U%" s.file 


Indicates that the get is for the purpose of editing or 
making a change (delta) to the SCCS file via a subse- 
quent use of delta (7). The -e keyletter used in a get for 
a particular version (SID) of the SCCS file prevents 
further gets for editing on the same SID until de/ta is 
executed or the j (joint edit) flag is set in the SCCS file 
(see admin (1)). Concurrent use of get —e for different 
SIDs is always allowed. 


If the g-file generated by get with an -e keyletter is 
accidentally ruined in the process of editing it, it may be 
regenerated by re-executing the get command with the 
—k keyletter in place of the -e keyletter. 


SCCS file protection specified via the ceiling, floor, and 
authorized user list stored in the SCCS file (see admin 
(1)) are enforced when the -e keyletter is used. 


Used with the -e keyletter to indicate that the new delta 
should have an SID in a new branch as shown in 
Table 1. This keyletter is ignored if the b flag is not 
present in the file (see admin (7)) or if the retrieved 
delta is not a leaf delta . (A leaf delta is one that has no 
successors on the SCCS file tree.) 

Note: A branch delta may always be created from a 
non-leaf delta . 


A list of deltas to be included (forced to be applied) in 
the creation of the generated file. The /ist has the follow- 
ing syntax: 


<list> = <range> <list> , <range> 
<range> ::= SID SID —SID 


SID, the SCCS Identification of a delta, may be in any 
form shown in the “SID Specified” column of Table 1. 
Partial SIDS are interpreted as shown in the “SID 
Retrieved” column of Table 1. 


A list of deltas to be excluded (forced not to be applied) 
in the creation of the generated file. See the -i keyletter 
for the /ist format. 
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Suppresses replacement of identification keywords (see 
below) in the retrieved text by their value. The —k 
keyletter is implied by the -e keyletter. 


Causes a delta summary to be written into an /-file . If 
-Ip is used then an /-file is not created; the delta sum- 
mary is written on the standard output instead. See 
FILES for the format of the /-file . 


Causes the text retrieved from the SCCS file to be written 
on the standard output. No g-file is created. All output 
which normally goes to the standard output goes to file 
descriptor 2 instead, unless the —s keyletter is used, in 
which case it disappears. 


Suppresses all output normally written on the standard 
output. However, fatal error messages (which always go 
to file descriptor 2) remain unaffected. 


Causes each text line retrieved from the SCCS file to be 
preceded by the SID of the deita that inserted the text 
line in the SCCS file. The format is: SID, followed by a 
horizontal tab, followed by the text line. 


Causes each generated text line to be preceded with the 
%M% identification Keyword value (see below). The for- 
mat is: %M% value, followed by a horizontal tab, fol- 
lowed by the text line. When both the -m and -n 
keyletters are used, the format is: %M°o value, followed 
by a horizontal tab, followed by the -—m keyletter gen- 
erated format. 


Suppresses the actual retrieval of text from the SCCS 
file. It is primarily used to generate an /-file , or to verify 
the existence of a particular SID. 


_ Used to access the most recently created (‘top’) delta in 


a given release (e.g., -r1 ), or release and level (e.g., 
—r1.2 ). 


Substitute string for all occurrences of 
@(#)get.1 6.2 when geting the file. 


The delta sequence number of the SCCS file delta (ver- 
sion) to be retrieved (see sccsfile(5)). This keyletter is 
used by the comb (1) command; it is not a generally 
useful keyletter, and users should not use it. If both the 
-r and —a keyletters are specified, the —a keyletter is 
used. Care should be taken when using the —a keyletter 
in conjunction with the -e keyletter, as the SID of the 
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delta to be created may not be what one expects. The 
-r keyletter can be used with the —a and —e keyletters to 
control the naming of the SID of the delta to be created. 


For each file processed, get responds (on the standard output) with 
the SID being accessed and with the number of lines retrieved from 
the SCCS file. 


If the -e keyletter is used, the SID of the delta to be made appears 
after the SID accessed and before the number of lines generated. If 
there is more than one named file or if a directory or standard input 
is named, each file name is printed (preceded by a new-line) before 
it is processed. If the -i keyletter is used included deltas are listed 
following the notation “Included”; if the —x keyletter is used, 
excluded deltas are listed following the notation “Excluded”. 


TABLE 1. Determination of ScCS Identification String 


tert een re reenter tre ee ra Sane neater renee 


SID* —b Keyletter Other SID SIO of Delta 
Specified Usedt Conditions _ Retrieved to be > Created | 7 
none= no _R defaults ults tomR —mR.1 mL nL mR. (mL - = -1) 7 a 
none: yes R defaults to mR mR.mL_ —_mR.mL.(mB = 1).1 
Romo RMR mR MR 
R no R= mR mR.mL  omR(mbL-1) 
R yes R>mR mR.mL mR.mL.(mB ~ 1).1 
R yes qomille mR.mL__mAR.mL.(mB ~ 4).1 
R oe ane hR.mL** — -hR.mL.(mB~1).1 


R does not exist 
Trunk succ.# 


R _ in release > R R.mL R.mL.(mB + 1).1 
_ and R exists 
RL no -—-Notrunk succ. = RL R.(L~+1) a 
R.L yes No trunk Succ. R.L R.L.(mB = 1).1 
R.L - ook oe sel R.L.(mB+1).1 
R.L.B no No branch succ. R.L.BomS R.L.B.(mS+1) 
R.L.B yes No branch succ. R.L.B.mS- RL. ue og 
R.L.B.S no No branch succ. R.L.B.S R.L.B.(S +1) 
R.L.B.S yes No branch succ. R.L.B.S R.L. rere 
R.L.B.S ~ Branch succ. R.L.B.S R.L.(mB +1).1 


7 "R", “LL” “B", and “S” are the ‘release’, ‘level’, “branch”, and 
“sequence’ components of the SID, respectively; “m’” means 
“maximum”. Thus, for example, “R.mL” means “the maximum 
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level number within release R”; “R.L.(mB+1).1” means “the 
first sequence number on the new branch (i.e., maximum 
branch number plus one) of level L within release R”. Note that 
if the SID specified is of the form “R.L”, “R.L.B’, or “R.L.B.S”, 
each of the specified components must exist. 

“AR” is the highest existing release that is lower than the speci- 
fied, nonexistent , release R. 

This is used to force creation of the first delta in a new release. 
Successor. 

The —b keyletter is effective only if the b flag (see admin (7)) is 
present in the file. An entry of — means “irrelevant”. 

This case applies if the d (default SID) flag is not present in the 
file. If the d flag /s present in the file, then the SID obtained 
from the d flag is interpreted as if it had been specified on the 
command line. Thus, one of the other cases in this table 
applies. 


IDENTIFICATION KEYWORDS 
Identifying information is inserted into the text retrieved from the 
SCCS file by replacing identification keywords with their value wher- 
ever they occur. The following keywords may be used in the text 
stored in an SCCS file: 
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Keyword Value 


YoM%o 


Yol% 


%R% 
YL% 
%B% 
%S% 
%D% 
%MH% 
%T% 
%E% 
%G% 
%YU% 
%Y Yo 


Yor Yo 
%P % 
WQ% 


Module name: either the value of the m flag in the file 
(see admin (1)), or if absent, the name of the SCCS file 
with the leading s. removed. 

SCCS identification (SID) (%R%.%L%.%B%.%S%) of the 
retrieved text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY MM. DD). 

Current date (MM.DD:YY). 

Current time (HH:MM:SS). 

Date newest applied delta was created (YY.MM:DD). 
Date newest applied delta was created (MM,/DD’YY). 
Time newest applied delta was created (HH:MM:SS). 
Module type: value of the t flag in the SCCS file 
admin (1)). 

SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see admin (1)). 


(see 
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%C% Current line number. This Keyword is intended for identi- 
fying messages output by the program such as “this 
should not have happened” type errors. It is not 
intended to be used on every line to provide sequence 
numbers. 

%L%o The 4-character string @(#) recognizable by what (7). 

YW A shorthand notation for constructing what (17) strings for 


UNIX system program files. 
YW% = %L%%M%< horizontal-tab > %1% 
VAX Another shorthand notation for constructing what (1) 


strings for non-UNIX system program files. 
WAN = %MLVWVY% YM% %l%V%LV% 


several auxiliary files may be created by get. These files are known 
generically as the g-file , I-file , p-file , and z-file . The letter before 
the hyphen is called the tag. An auxiliary file name is formed from 
the SCCS file name: the last component of all SCCS file names must 
be of the form s.module-name, the auxiliary files are named by 
replacing the leading s with the tag. The g-file is an exception to 
this scheme: the g-file is named by removing the s. prefix. For 
example, s.xyz.c , the auxiliary file names would be xyz.c , |.xyz.c , 
p.xyz.c , and z.xyz.c , respectively. 


The g-file , which contains the generated text, is created in the 
current directory (unless the -p keyletter is used). A 9g-file is 
created in all cases, whether or not any lines of text were generated 
by the get . It is owned by the real user. If the -k keyletter is used 
or implied its mode is 644; otherwise its mode is 444. Only the real 
user need have write permission in the current directory. 


The /-file contains a table showing which deltas were applied in gen- 
erating the retrieved text. The /-file is created in the current direc- 
tory if the -I keyletter is used; its mode is 444 and it is owned by the 
real user. Only the real user need have write permission in the 
current directory. 


Lines in the /-file have the following format: 


a. A blank character if the delta was applied; 
* otherwise. 
b. A blank character if the delta was applied or was 


not applied and ignored; 
* if the delta was not applied and was not ignored. 
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C A code indicating a “special” reason why the delta 
was or was not applied: 

“I: Included. 

“X": Excluded. 

“C": Cut off (by a —c keyletter). 
d. Blank. 
e. SCCS identification (SID). 
f. Tab character. 
g. Date and time (in the form YY/MM/DD HH:MM:SS) of 

| creation. 

h. Biank. 


Login name of person who created delta. 


The comments and MR data follow on subsequent lines. 
indented one horizontal tab character. A blank line ter- 
minates each entry. 


The p-file is used to pass information resulting from a gef with an 
—e keyletter along to delta . Its contents are also used to prevent a 
subsequent execution of get with an —e keyletter for the same SID 
until deita is executed or the joint edit flag, j , (see admin (7)) is set 
in the SCCS file. The p-file is created in the directory containing the 
SCCS file and the effective user must have write permission in that 
directory. Its mode is 644 and it is owned by the effective user. 
The format of the p-file is: the gotten SID, followed by a blank, fol- 
lowed by the SID that the new delta will have when it is made, fol- 
lowed by a blank, followed by the login name of the real user, fol- 
lowed by a blank, followed by the date-time the get was executed, 
followed by a blank and the -i keyletter argument if it was present, 
followed by a blank and the —x keyletter argument if it was present, 
followed by a new-line. There can be an arbitrary number of lines in 
the p-file at any time; no two lines can have the same new delta 
SID. 


The z-file serves as a lock-out mechanism against simultaneous 
updates. Its contents are the binary (2 bytes) process !D of the 
command (i.e., get) that created it. The z-file is created in the 
directory containing the SCCS file for the duration of get. The same 
protection restrictions as those for the p-file apply for the z-file . The 
z-file is created mode 444. 


SEE ALSO 
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admin(1), delta(1), help(1), prs(1), what(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System in the Sys5 UNIX Support Tools 
Guide . 
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DIAGNOSTICS 
Use help (7) for explanations. 


( BUGS 
lf the effective user has write permission (either explicitly or impli- 
citly) in the directory containing the SCCS files, but the real user 
does not, then only one file may be named when the —e keyletter ts 
used. 
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NAME 
getopt — parse command options \ 

SYNOPSIS Oe 
set — *<getopt optstring $*-* 

DESCRIPTION 


Getopt is used to break up options in command lines for easy pars- 
ing by shell procedures and to check for legal options. Optstring is 
a string of recognized option letters (see getopt(3C)); if a letter is 
followed by a colon, the option is expected to have an argument 
which may or may not be separated from it by white space. The 
special option — is used to delimit the end of the options. If it is 
used explicitly, getopt will recognize it; otherwise, gefopt will gen- 
erate it; in either case, getopt will place it at the end of the options. 
The positional parameters ($1 $2 ...) of the shell are reset so that 
each option is preceded by a — and is in its own positional parame- 
ter; each option argument is also parsed into its own positional 
parameter. 


EXAMPLE 


The following code fragment shows how one might process the 
arguments for a command that can take the options a or b, as well 


as the option o , which requires an argument: a 
set — ~-getopt abo: $** Ba 
if [ $7? '= 0 | 
then 
echo $USAGE 
exit 2 

fi 

for i in $x 

do 
case $i in 
—a | -b) FLAG=$i; shift;; 
—O) OARG= $2; shift 2:; 
=e) shift; break;; 
esac 

done 


This code will accept any of the following as equivalent: 


cmd —aoarg file file 

cmd —a -0 arg file file 
cmd —oarg —a file file 
cmd —a —oarg — file file 


SEE ALSO ( 
sh(1), getopt(3C). = 
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DIAGNOSTICS 
Gefopt prints an error message on the standard error when it 
encounters an option letter not included in optstring . 
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NAME 
graph — draw a graph 
SYNOPSIS 
graph [ options | 
DESCRIPTION 
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Graph with no options takes pairs of numbers from the standard 
input as abscissas and ordinates of a graph. Successive points are 
connected by straight lines. The graph is encoded on the standard 
output for display by the tp/ot (1G) filters. 


If the coordinates of a point are followed by a non-numeric string, 
that string is printed as a label beginning on the point. Labels may 
be surrounded with quotes ", in which case they may be empty or 
contain blanks and numbers; labels never contain new-lines. 


The following options are recognized, each as a separate argument: 


—a 


Supply abscissas automatically (they are missing from 
the input); spacing is given by the next argument (default 
1). A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by —x 
). 

Break (disconnect) the graph after each label in the 
input. 

Character string given by next argument is default label 
for each point. 

Next argument is grid style, 0 no grid, 1 frame with ticks, 
2 full grid (default). : 

Next argument is label for graph. 

Next argument is mode (style) of connecting lines: 0 
disconnected, 1 connected (default). Some devices give 
distinguishable line styles for other small integers (e.g., 
the TEKTRONIX 4014: 2=dotted, 3=dash-dot, 4=shor- 
dash, 5=long-dash). 

Save screen, do not erase before plotting. 

If lis present, x axis is logarithmic. Next 1 (or 2) argu- 
ments are lower (and upper) x limits. Third argument, if 
present, is grid spacing on x axis. Normally these quan- 
tities are determined automatically. 

Similarly for y . 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before 
plotting. 
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—u Similarly to move up before plotting. 

—t Transpose horizontal and vertical axes. (Option —x now 
applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the -s 

option is present. If a specified lower limit exceeds the upper limit, 

the axis is reversed. 


SEE ALSO 
graphics(1G), spline(1G), tplot(1G). 

BUGS 
Graph stores all points internally and drops those for which there is 
no room. 


Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 


graphics — access graphical and numerical commands 


SYNOPSIS 


graphics [ -r | 


DESCRIPTION 


Graphics prefixes the path name /usr/bin/graf to the current $PATH 
value, changes the primary shell prompt to *, and executes a new 
shell. The directory /usr/bin/graf contains all of the Graphics sub- 
system commands. lf the -r option is given, access to the graphical 
commands is created in a restricted environment; that is, $PATH is 
set to 
/usr/bin/graf:/rbin:/usr/ 

and the restricted shell, rsh , is invoked. To restore the environment 
that existed prior to issuing the graphics command, type EOT 
(control-d on most terminals). To logoff from the graphics environ- 
ment, type quit . 


The command line format for a command in graphics is command 
name followed by argument(s). An argument may be a file name or 
an option string. A file name is the name of any UNIX system file 
except those beginning with -. The file name — is the name for the 
standard input. An option string consists of — followed by one or 
more option(s). An option consists of a keyletter possibly followed 
by a value. Options may be separated by commas. 


The graphical commands have been partitioned into four groups. 


Commands that manipulate and plot numerical data; see 
stat (1G). 


Commands that generate tables of contents; see toc (1G). 


Commands that interact with graphical devices; see Egaey 
(1G) and ged (1G). 


A collection of graphical utility commands; see gutil (1G). 


A list of the graphics commands can be generated by typing whatis 
in the graphics environment. 


SEE ALSO 
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gdev(1G), ged(1G), gutil(1G), stat(1G), toc(1G). 


gps(4) in the Sys5 UNIX Programmer Reference Manual. 


Sys5 UNIX Graphics Guide . 
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NAME 
greek — select terminal filter 
SYNOPSIS 
creek [ —T terminal ] 
DESCRIPTION 
Greek is a filter that reinterprets the extended character set, as well 
as the reverse and half-line motions, of a 128-character TELETYPE® 
Model 37 terminal (which is the nroff (7) default terminal) for certain 
other terminals. Special characters are simulated by overstriking, if 
necessary and possible. If the argument is omitted, greek attempts 
to use the environment variable $TERM (see environ (5)). The fol- 
lowing terminal s are recognized currently: 
300 DAS! 300. 
300-12 DASI 300 in 12-pitch. 
300s DASI 300s. 
300s-12 DAS! 300s in 12-pitch. 
450 DAS! 450. 
450-12 DAS! 450 in 12-pitch. 
1620 Diablo 1620 (alias DAS! 450). 
1620-12 Diablo 1620 (alias DASI 450) in 12-pitch. 
2621 Hewlett-Packard 2621, 2640, and 2645. 
2640 Hewlett-Packard 2621, 2640, and 2645. 
2645 Hewlett-Packard 2621, 2640, and 2645. 
4014 TEKTRONIX 4014. 
hp Hewlett-Packard 2621, 2640, and 2645. 
tek TEKTRONIX 4014. 
FILES 
/usr/bin/300 
/usr/bin/300s 
/usr/bin/4014 
/usr/bin/450 
/usr/bin/hp 
SEE ALSO 
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300(1), 4014(1), 450(1), eqn(1), hp(1), mm(1), nroff(1), tplot(1G). 
environ(5), term(5) in the Sys5 UNIX Programmer Reference 
Manual. 

Sys5 UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. 
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NAME 


grep, egrep, fgrep — search a file for a pattern 


SYNOPSIS 


grep [ options ] expression [ files ] 
egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 


DESCRIPTION 
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Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is 
copied to the standard output. Grep patterns are limited regular 
expression s in the style of ed (17); it uses a compact non- 
deterministic algorithm. Egrep patterns are full regular expression 
s; it uses a fast deterministic algorithm that sometimes needs 
exponential space. Fgrep patterns are fixed strings ; it is fast and 
compact. The following options are recognized: 


-V All lines but those matching are printed. 

—X (Exact) only lines matched in their entirety are printed (fgrep 
only). 

—c Only acount of matching lines is printed. 

—I Ignore upper/lower case distinction during comparisons. 

—| Only the names of files with matching unES are listed (once), 
separated by new-lines. 

-—n Each line is preceded by its relative line number in the file. 

—b Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 
numbers by context. 

-S The error messages produced for nonexistent or unreadable 
files are suppressed (grep only). 

—e expression 
Same as a simple expression argument, but useful when the 
expression begins with a — (does not work with grep ). 

-f file The regular expression (egrep) or strings \ist (fgrep) is 
taken from the file . 


In all cases, the file name is output if there is more than one input 
file. Care should be taken when using the characters $ ,*,[,~*, |, 
(,), and \ in expression , because they are also meaningful to the 
shell. It is safest to enclose the entire expression argument in sin- 
gle quotes ’ ... ’ 


Fgrep searches for lines that contain one of the strings separates 
by new-lines. 
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Egrep accepts regular expressions as in ed (7), except for \( and \) 
, with the addition of: 


1. A regular expression followed by + matches one or more 
occurrences of the regular expression. 

a A regular expression followed by ? matches O or 1 
occurrences of the regular expression. 

3. Two regular expressions separated by | or by a new-line 
match strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for 
grouping. 


The order of precedence of operators is [] , then *?+ , then con- 
catenation, then | and new-line. 


SEE ALSO 
ed(1), sed(1), sh(1). 


DIAGNOSTICS 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax 
errors or inaccessible files (even if matches were found). 


BUGS 
Ideally there should be only one grep , but we do not know a single 
algorithm that spans a wide enough range of space-time tradeoffs. 
Lines are limited to BUFSIZ characters; longer lines are truncated. 
(BUFSIZ is defined in /usr/include/stdio.h .) 
Egrep does not recognize ranges, such as [a-z] , in character 
classes. 
If there is a line with embedded nulls, grep will only match up to the 
first null; if it matches, it will print the entire line. 
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gutil — graphical utilities 


SYNOPSIS 
command-name [options] [files] 


DESCRIPTION 
Below is a list of miscellaneous device independent utility com- 
mands found in /usr/bin/graf . If no files are given, input is from the 
standard input. All output is to the standard output. Graphical data 
is stored in GPS format; see gps (4). 


bel 
cvriopt 


god 


— send bel character to terminal 


[ =sstring fstring istring tstring | [args | — options con- 
verter 
Cvrtopt reformats args (usually the command line argu- 
ments of a calling shell procedure) to facilitate process- 
ing by shell procedures. An arg is either a file name (a 
string not beginning with a -, or a — by itself) or an option 
string (a string of options beginning with a —). Output is 
of the form: 

—option -option. .. file name(s) 
All options appear singularly and preceding any file 
names. Options that take values (e.g., -r1.1) or are 
two-letters long must be described through options to 
cvrtopt. 


Cvrtopt is usually used with set in the following manner 
as the first line of a shell procedure: 

set — cvrtopt =[" options "] $@*" 
Options to cvrtopt are: 


sstring String accepts string values. 
fstring String accepts floating point numbers as 


values. 

istring String accepts integers as values. 

tstring String is a two-letter option name that takes 
no value. 


String is a one- or two-letter option name. 


[GPS files | —GPS dump 
Gd prints a human readable listing of GPS. 
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gtop 


pd 


ptog 


quit 


remcom 


whatis 


yoo 


SEE ALSO 
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[-rnu ] [GPS files | — GPS to p/ot(4) filter 

Gtop transforms a GPS into p/ot(4) commands display- 
able by plot filters. GPS objects are translated if they fall 
within the window that circumscribes the first file unless 
an option is given. 

Options: 


rn translate objects in GPS region n. 
u translate all objects in the GPS universe. 


[ plot(5) files | — plot(4) dump 
Pd prints a human readable listing of plot(4) format 
graphical commands. 


[ plot(S) files | — plot(4) to GPS filter 
Ptog transforms p/ot(4) commands into a GPS. 


— terminate session 


[ files | — remove comments 

Remcom copies its input to its output with comments 
removed. Comments are as defined in C (i.e., /* com- 
ment */). 


[-o | [ names | — brief on-line documentation 

Whatis prints a brief description of each name given. If 
no name is given, then the current list of description 
names is printed. The command whatis \* prints out 
every description. 

Option: 


O just print command o ptions 


file — pipe fitting 

Yoo Is a piping primitive that deposits the output of a 
pipeline into a file used in the pipeline. Note that, without 
yoo, this is not usually successful as it causes a read 
and write on the same file simultaneously. 


graphics(1G). 
gps(4), plot(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
head — give first few lines of a stream 
SYNOPSIS 
| /usr/plx/head [ —count ] [ file... | 
~ DESCRIPTION 


This filter gives the first count lines of each of the specified files, or 
of the standard input. If count is omitted it defaults to 10. 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
tail(1) 
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NAME 

help — ask for help 
SYNOPSIS 

help [args] 


DESCRIPTION 
Help finds information to explain a message from a command or 
explain the use of a command. Zero or more arguments may be 
supplied. If no arguments are given, he/p will prompt for one. 


The arguments may be either message numbers (which normally 
appear in parentheses following messages) or command names, of 
one of the following types: 


type 1 Begins with non-numerics, ends in numerics. 
The non-numeric prefix is usually an abbrevi- 
ation for the program or set of routines which 
produced the message (e.g., ge6, for mes- 
sage 6 from the gef command). 


type 2 Does not contain numerics (as a command, 
such as get ) 


type 3 Is all numeric (e.g., 212) 


The response of the program will be the explanatory information 
related to the argument, if there is any. 


When all else fails, try “help stuck”. 


FILES 
/ust/lib/help directory containing files of message 
text. 
/usr/lib/help/helploc file containing locations of help files not 


In /usr/lib/help. 


DIAGNOSTICS 
Use help (7) for explanations. 
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NAME 

hp — handle special functions of HP 2640 and 2621-series terminals 
SYNOPSIS 

hp [-e |] [ -m ] 
DESCRIPTION 


Hp supports special functions of the Hewlett-Packard 2640 series of 
terminals, with the primary purpose of producing accurate represen- 
tations of most nroff output. A typical use is: 


nroff —h files ... | hp 


Regardless of the hardware options on your terminal, Ap tries to do 
sensible things with underlining and reverse line-feeds. If the termi- 
nal has the “display enhancements” feature, subscripts and super- 
scripts can be indicated in distinct ways. If it has the 
“mathematical-symbol” feature, Greek and other special characters 
can be displayed. 


The flags are as follows: 

-e It is assumed that your terminal has the “display enhance- 
ments’ feature, and so maximal use is made of the added 
display modes. Overstruck characters are presented in the 
Underline mode. Superscripts are shown in Half-bright 
mode, and subscripts in Half-bright, Underlined mode. If 
this flag is omitted, hp assumes that your terminal lacks the 
“display enhancements” feature. In this case, all overstruck 
characters, subscripts, and superscripts are displayed in 
Inverse Video mode, |.e., dark-on-light, rather than the usual 
light-on-dark. 

—m Fequests minimization of output by removal of new-lines. 
Any contiguous sequence of 3 or more new-lines is con- 
verted into a sequence of only 2 new-lines; i.e., any number 
of successive blank lines produces only a single blank out- 
put line. This allows you to retain more actual text on the 
screen. 


With regard to Greek and other special characters, hp provides the 
same set as does 300 (1), except that “not” is approximated by a 
right arrow, and only the top half of the integral sign is shown. The 
display is adequate for examining output from neqn . 


DIAGNOSTICS 
“line too long” if the representation of a line exceeds 1,024 charac- 
ters. 
The exit codes are 0 for normal termination, 2 for all errors. 


SEE ALSO 
300(1), col(1), eqn(1), greek(1), nroff(1), tbi(1). 
Sys5 UNIX Documenter’s Workbench Software Introduction and 
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Reference Manual. 


An “overstriking sequence’ is defined as a printing character fol- 
lowed by a backspace followed by another printing character. In 
such sequences, if either printing character is an underscore, the 
other printing character is shown underlined or in Inverse Video; oth- 
erwise, only the first printing character is shown (again, underlined 
or in Inverse Video). Nothing special is done if a backspace is adja- 
cent to an ASCII control character. Sequences of control characters 
(e.g., reverse line-feeds, backspaces) can make text “disappear’; in 
particular, tables generated by fb/ (7) that contain vertical lines will 
often be missing the lines of text that contain the “foot” of a vertical 
line, unless the input to hp is piped through col (7). 

Although some terminals do provide numerical superscript charac- 
ters, no attempt is made to display them. 
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NAME 
hyphen — find hyphenated words 


SYNOPSIS 
hyphen [ files | 


DESCRIPTION 
Hyphen finds all the hyphenated words ending lines in files and 
prints them on the standard output. If no arguments are given, the 
standard input is used; thus, hyphen may be used as a filter. 


EXAMPLE 
The following will allow the proofreading of nroff hyphenation in 
textfile . 
mm textfile | hyphen 
SEE ALSO 


mm(1), nroff(1). 


BUGS 
Hyphen cannot cope with hyphenated /talic (i.e., underlined) words; 
it will often miss them completely, or mangle them. 
Hyphen occasionally gets confused, but with no ill effects other than 
spurious extra output. 
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NAME se 
id — print user and group IDs and names ; 
oe 
SYNOPSIS ~ 
id 
DESCRIPTION 
Id writes a message on the standard output giving the user and 
group IDs and the corresponding names of the invoking process. If 
the effective and real IDs do not match, both are printed. | 
SEE ALSO 
logname(1). 
getuid(2) in the Sys5 UNIX Programmer Reference Manual. 
es 
es 
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NAME 
ipcrm — remove a message queue, semaphore set or shared 
memory id 

SYNOPSIS 


ipcrm [ options | 


DESCRIPTION 
locrm will remove one or more specified messages, semaphore or 
shared memory identifiers. The identifiers are specified by the fol- 
lowing options: 


-qmsqid _—s removes the message queue identifier msgid from the 
system and destroys the message queue and data 
structure associated with it. 


—-m shmid — removes the shared memory identifier shmid from the 
system. The shared memory segment and data struc- 
ture associated with it are destroyed after the last 
detach. 


-S semid removes the semaphore identifier semid from the sys- 
tem and destroys the set of semaphores and data 
structure associated with it. 


-—Q msgkey removes the message queue identifier, created with 
key msgkey, from the system and destroys the mes- 
sage queue and data structure associated with it. 


—-M shmkey removes the shared memory identifier, created with 
key shmkey, from the system. The shared memory 
segment and data structure associated with it are des- 
troyed after the last detach. 


-S semkey removes the semaphore identifier, created with key 
semkey, from the system and destroys the set of 
semaphores and data structure associated with it. 


The details of the removes are described in msgctl(2), shmctl(2), 
and semcti(2). The identifiers and keys may be found by using 
ipcs(1). 
SEE ALSO 

ipcs(1). 

msgctl(2), msgget(2), msgop(2), semctl(2), semget(2), semop(2), 
shmetl(2), shmget(2), shmop(2) in the Sys5 UNIX Programmer 
Reference Manual. 
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NAME 


iocs — report inter-process communication facilities status 


SYNOPSIS 


ipcs [ options ] - 


DESCRIPTION 


‘age 1 


locs prints certain information about active inter-process communi- 
cation facilities. Without options , information is printed in short for- 
mat for message queues, shared memory, and semaphores that are 
currently active in the system. Otherwise, the information that is 
displayed is controlled by the following options : 


158.spQu | 

-q Print information about active message queues. 

—m Print information about active shared memory segments. 
-S Print information about active semaphores. 


If any of the options -q , -m , or -s are specified, information about 
only those indicated will be printed. If none of these three are speci- 
fied, information about all three will be printed. 


—b Print biggest allowable size information. (Maximum number 
of bytes in messages on queue for message queues, size of 
segments for shared memory, and number of semaphores 
in each set for semaphores.) See below for meaning of 
columns in a listing. 

—C Print creator's login name and group name. See below. 

-O Print information on outstanding usage. (Number of mes- 
Sages on queue and total number of bytes in messages on 
queue for message queues and number of processes 
attached to shared memory segments. ) 

—p Print process number information. (Process ID of last pro- 
cess to send a message and process ID of last process to 
receive a message on message queues and process ID of 
creating process and process ID of last process to attach or 
detach on shared memory segments) See below. 

—t Print time information. (Time of the last control operation 
that changed the access permissions for all facilities. Time 
of last msgsnd and last msgrcv on message queues, last 
shmat and last shmat on shared memory, last semop (2) 
on semaphores.) See below. 


—a Use all print options . (This is a shorthand notation for —b , 
—C ,-0O,-p, and-t.) 
-C corefile 


Use the file corefile in place of ;dev/‘kmem . 
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; —N namelist 
( ; The argument will be taken as the name of an alternate 
L namelist (/unix is the default). 


The column headings and the meaning of the columns in an ipcs 
listing are given below; the letters in parentheses indicate the 
options that cause the corresponding heading to appear; all means 
that the heading always appears. Note that these options only 
determine what information is provided for each facility; they do not 
determine which facilities will be listed. 


T (all) Type of the facility: 
q message queue; 
m shared memory segment; 
Ss semaphore. 
ID (all) The identifier for the facility entry. 
KEY (all) The key used as an argument to msgget , semget 


, or shmget to create the facility entry. (Note: 
The key of a shared memory segment is changed 
to IPC_PRIVATE when the segment has been 
removed until all processes attached to the seg- 
ment detach it.) 


: MODE (all) The facility access modes and flags: The mode 
( consists of 11 characters that are interpreted as 
follows: 


The first two characters are: 

Rif a process is waiting on a msgrcv ; 

Sif a process is waiting on a msgsnd ; 

Dif the associated shared memory seg- 
ment has been removed. It will 
disappear when the last process 
attached to the segment detaches tt; 

Cif the associated shared memory seg- 
ment is to be cleared when the first 
attach is executed; 

- if the corresponding special flag is 
not set. 


The next 9 characters are interpreted as three 
sets of three bits each. The first set refers to the 
owner's permissions; the next to permissions of 
others in the user-group of the facility entry; and 
the last to all others. Within each set, the first 
character indicates permission to read, the 
second character indicates permission to write or 
alter the facility entry, and the last character is 


May 29, 1985 Page 2 


IPCS(1) 


OWNER 
GROUP 


CREATOR 
CGROUP 


CBYTES 
QNUM 


QBYTES 


LSPID 
LRPID 
STIME 
RTIME 
CTIME 
NATTCH 
SEGSZ 
CPID 
LPID 
ATIME 
DTIME 


NSEMS 
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(all) 
(all) 


(a,c) 
(a,c) 


(a,o) 
(a,o) 


(a,b) 


(a,p) 
(a,p) 
(a,t) 
(a,t) 
(a,t) 
(a,0) 
(a,b) 
(a,p) 
(a,p) 
(a,t) 
(a,t) 


(a,b) 
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currently unused. 
The permissions are indicated as follows: 


r if read permission is granted; 

wif write permission is granted; 

aif alter permission is granted; 

- if the indicated permission is not 

granted. 

The login name of the owner of the facility entry. 
The group name of the group of the owner of the 
facility entry. 
The login name of the creator of the facility entry. 
The group name of the group of the creator of the 
facility entry. 
The number of bytes in messages currently out- 
standing on the associated message queue. 
The number of messages currently outstanding on 
the associated message queue. 
The maximum number of bytes allowed in mes- 
sages outstanding on the associated message 
queue. 
The process ID of the last process to send a mes- 
sage to the associated queue. 
The process ID of the last process to receive a 
message from the associated queue. 
The time the last message was sent to the associ- 
ated queue. 
The time the last message was received from the 
associated queue. 
The time when the associated entry was created 
or changed. 
The number of processes attached to the associ- 
ated shared memory segment. 
The size of the associated shared memory seg- 
ment. 
The process ID of the creator of the shared 
memory entry. 
The process ID of the last process to attach or 
detach the shared memory segment. 
The time the last attach was completed to the 
associated shared memory segment. 
The time the last detach was completed on the 
associated shared memory segment. 
The number of semaphores in the set associated 
with the semaphore entry. 
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OTIME (a,t) The time the last semaphore operation was com- 
pleted on the set associated with the semaphore 
entry. 

FILES 
/UNIX system namelist 


/dev/kmem memory 
/etc/passwd user names 
/etc/group group names 


SEE ALSO 
msgop(2), semop(2), shmop(2) in the Sys5 UNIX Programmer 
Reference Manual. 


BUGS 
Things can change while /pcs is running; the picture it gives is only 
a close approximation to reality. 
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NAME 


join — relational database operator 


SYNOPSIS 


join [ options | file1 file2 


DESCRIPTION 


Page 1 


Join forms, on the standard output, a join of the two relations speci- 
fied by the lines of file? and file2 . If file? is -, the standard input is 
used. 


File? and file2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be joined, normally the first in 
each line. 


There is one line in the output for each pair of lines in file? and file2 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from file? , then the rest 
of the line from file2 . 


The default input field separators are blank, tab, or new-line. In this 
case, muitiple separators count as one field separator, and leading 
separators are ignored. The default output field separator is a 
blank. 


Some of the below options use the argument n . This argument 
should be a 1 or a 2 referring to either file? or file2 , respectively. 
The following options are recognized: 


-an In addition to the normal output, produce a line for each 
unpairable line in file n , where 7 is 1 or 2. 


—es Replace empty output fields by string s . 


-jnm Join on the m th field of filen. If n is missing, use the m th 
field in each file. Fields are numbered starting with 1. 


—o fist Each output line comprises the fields specified in list , each 
element of which has the form n.m, where n is a file number 
and m is a field number. The common field is not printed 
unless specifically requested. 


—tc Use character c as a separator (tab character). Every 
appearance of c in a line is significant. The character c is 
used as the field separator for both input and output. 
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EXAMPLE 
The following command line will join the password file and the group 
file, matching on the numeric group ID, and outputting the login 
name, the group name and the login directory. It is assumed that 
the files have been sorted in ASCII collating sequence on the group 
ID fields. 


join -j1 4 -j2 3-0 1.1 2.1 1.6 -t: /etc/passwd /etc’/group 
SEE ALSO 
awk(1), comm(1), sort(1), uniq(1). 


BUGS 
With default field separation, the collating sequence is that of sort 
—b ; with -t , the sequence is that of a plain sort. 


The conventions of join , sort , comm , unig and awk (7) are wildly 
incongruous. 


Filenames that are numeric may cause conflict when the -o option is 
used right before listing filenames. 
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kill — terminate a process 


SYNOPSIS 


kill [ — signo ] PID ... 


DESCRIPTION 


Kill sends signal 15 (terminate) to the specified processes. This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is 
reported by the Shell (unless more than one process is started in a 
pipeline, in which case the number of the last process in the pipeline 
is reported). Process numbers can also be found by using ps (7). 


The details of the kill are described in kill (2). For example, if pro- 
cess number 0 is specified, all processes in the process group are 
signaled. 


The killed process must belong to the current user unless he is the 
Super-user. 


If a signal number preceded by — is given as first argument, that sig- 
nal is sent instead of terminate (see signal (2)). In particular “kill —9 
.. Is a sure kill. 


SEE ALSO 
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ps(1), sh(1). 
kill(2), signal(2) in the Sys5 UNIX Programmer Reference Manual. 
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ld — link editor for common object files 


SYNOPSIS 


Id [options] filename 


DESCRIPTION 


Page 1 


The /d command combines several object files into one, performs 
relocation, resolves external symbols, and supports symbol table 
information for symbolic debugging. In the simplest case, the 
names of several object programs are given, and /d combines them, 
producing an object module that can either be executed or used as 
input for a subsequent /d run. The output of /d is left in a.out . By 
default this file is executable if no errors occurred during the load. If 
any input file, file-name , is not an object file, /d assumes it Is either 
an archive library or a text file containing link editor directives. (See 
the Link Editor User Guide in the Sys5 UNIX Programmer Guide for 
a discussion of input directives.) 


lf any argument is a library, it is searched exactly once at the point it 
is encountered in the argument list. Only those routines defining an 
unresolved external reference are loaded. The library (archive) 
symbol table (see ar (4)) is searched sequentially with as many 
passes as are necessary to resolve external references which can 
be satisfied by library members. Thus, the ordering of library 
members is unimportant. 


The following options are recognized by /d . 


-—e epsym 
Set the default entry point address for the output file to be 
that of the symbol epsym . 


-f fill Set the default fill pattern for “holes” within an output sec- 
tion as well as initialized bss sections. The argument fill is a 
two-byte constant. 


—Ix Search a library libx.a, where x is up to seven characters. 
A library is searched when its name is encountered, so the 
placement of a -I is significant. By default, libraries are 
located in /lib and /usr/liby. 


—m Produce a map or listing of the input/output sections on the 
standard output. 


-o outfile 
Produce an output object file by the name outfile . The 
name of the default object file is a.out . 
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Retain relocation entries in the output object file. Relocation 
entries must be saved if the output file is to become an 
input file in a subsequent /d run. The link editor will not 
complain about unresolved references. 


Strip line number entries and symbol table information from 
the output object file. 


Turn off the warning about multiply-defined symbols that are 
not the same size. 


—u symname 


Enter symname as an undefined symbol in the symbol 
table. This is useful for loading entirely from a library, since 
initially the symbol table is empty and an unresolved refer- 
ence is needed to force the loading of the first routine. 


—X Do not preserve local (non-.globl) symbols in the output 
symbol table; enter external and static symbols only. This 
option saves some space in the output file. 

—L dir Change the algorithm of searching for libx.a to look in dir 
before looking in /lib and ‘usr‘lib. This option is effective 
only if it precedes the -I option on the command line. 

—M Output a message for each multiply-defined external defini- 
tion. However, if the objects being loaded include debug- 
ging information, extraneous output is produced (see the -g 
option in cc(1)). 

—N Put the data section immediately following the text in the 
output file. 

-V Output a message giving information about the version of Id 
being used. 

-VS num 
Use num as a decimal version stamp identifying the a.out 
file that is produced. The version stamp is stored in the 
optional header. 

FILES 

/lib/libx.a libraries 

/usr/lib/libx.a libraries 

a.out output file 

SEE ALSO 


as(1), cc(1). 
exit(2), a.out(4), ar(4) in the SysS UNIX Programmer Reference 


Manual. 
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_ CAVEATS 
( | Through its options and input directives, the common link editor 
Lo gives users great flexibility; however, those who use the input direc- 


tives must assume some added responsibilities. Input directives 
and options should insure the following properties for programs: 


~ C defines a zero pointer as null. A pointer to which zero has 
been assigned must not point to any object. To satisfy this, 
users must not place any object at virtual address zero in the 
data space. 


~ When the link editor is called through cc (7), a startup routine 
is linked with the user’s program. This routine calls exit() (see 
exit (2)) after execution of the main program. If the user calls 
the link editor directly, then the user must insure that the pro- 
gram always calls exit( ) rather than falling through the end of 
the entry routine. 
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NAME 
lex — generate programs for simple lexical tasks 
SYNOPSIS 
lex [ -rctvn | [ file ] ... 
DESCRIPTION 
Lex generates programs to be used in simple lexical analysis of 
text. 


The input files (standard input default) contain strings and expres- 
sions to be searched for, and C text to be executed when strings 
are found. 


A file lex.yy.c is generated which, when loaded with the library, 
copies the input to the output except when a string specified in the 
file is found; then the corresponding program text is executed. The 
actual string matched is left in yyfext , an external character array. 
Matching is done in order of the strings in the file. The strings may 
contain square brackets to indicate character classes, as in [abx-—z] 
to indicatea, b, x,y,and z; andthe operators +, + , and ? 
mean respectively any non-negative number of, any positive number 
of, and either zero or one occurrences of, the previous character or 
character class. The character . is the class of all ASCll characters 
except new-line. Parentheses for grouping and vertical bar for alter- 
nation are also supported. The notation r{d,e} in a rule indicates 
between d and e instances of regular expression r . It has higher 
precedence than |, but lower than * , ? , + , and concatenation. 
The character * at the beginning of an expression permits a suc- 
cessful match only immediately after a new-line, and the character $ 
at the end of an expression requires a trailing new-line. The charac- 
ter / in an expression indicates trailing context; only the part of the 
expression up to the slash is returned in yytext , but the remainder 
of the expression must follow in the input stream. An operator char- 
acter may be used as an ordinary symbol if it is within " symbols or 
preceded by \. Thus [a-zA-Z]+ matches a string of letters. 


Three subroutines defined as macros are expected: input() to read 
a character; unput(c) to replace a character read; and output(c) to 
place an output character. They are defined in terms of the stan- 
dard streams, but you can override them. The program generated 
is named yylex() , and the library contains a main{) which calls it. 
The action REJECT on the right side of the rule causes this match to 
be rejected and the next suitable match executed; the function 
yymore() accumulates additional characters into the same yytext ; 
and the function yyless(o) pushes back the portion of the string 
matched beginning at p , which should be between yytext and 
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yytext + yyleng . The macros input and output use files yyin and 
yyout to read from and write to, defaulted to stdin and stdout , 
respectively. 


Any line beginning with a blank is assumed to contain only C text 
and is copied; if it precedes %% it is copied into the external defini- 
tion area of the lex.yy.c file. All rules should follow a %% , as in 
YACC. Lines preceding %% which begin with a non-blank character 
define the string on the left to be the remainder of the line; it can be 
called out later by surrounding it with {} . Note that curly brackets do 
not imply parentheses; only string substitution is done. 


EXAMPLE 
D [0-9] 


if printf("IF statementin’); 
[a—z]+ printf("tag, value %s\n",yytext); 
O{D}+ — printf("octal number %s\n",yytext); 
{D}+ printf("“decimal number %s\n",yytext); 
"++" orintf(unary opin’); 
np printf(binary op\n’); 
Mie" { loop: 
while (input() }= °*’); 
switch (input()) 
{ 
case '.’: break: 
case '*’: unput(’*’); 
default: go to loop; 
i 
i 


The external names generated by /ex all begin with the prefix yy or 
YY. 


The flags must appear before any files. The flag —r indicates RAT- 
FOR actions, —c indicates C actions and is the default, -t causes the 
lex.yy.c program to be written instead to standard output, —v pro- 
vides a one-line summary of statistics of the machine generated, —n 
will not print out the - summary. Multiple files are treated as a sin- 
gle file. If no files are specified, standard input is used. 


Certain table sizes for the resulting finite state machine can be set 
in the definitions section: 


%pn number of positions is n (default 2000) 


%nn number of states is n (500) 
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%tn number of parse tree nodes is n (1000) 
%an number of transitions is n (3000) 


The use of one or more of the above automatically implies the —v 
option, unless the —n option is used. 


SEE ALSO 
yacc(1). 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


BUGS 
The -r option is not yet fully operational. 
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NAME 
line — read one line 


SYNOPSIS 
line 

DESCRIPTION 
Line copies one line (up to a new-line) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on EOF 
and always prints at least a new-line. It is often used within shell 
files to read from the user’s terminal. 


SEE ALSO 
sh(1). 
read(2) in the Sys5 UNIX Programmer Reference Manual. 
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lint — a C program checker 


SYNOPSIS 


lint [ option ] ... file ... 


DESCRIPTION 
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Lint attempts to detect features of the C program files that are likely 
to be bugs, non-portable, or wasteful. It also checks type usage 
more strictly than the compilers. Among the things that are 
currently detected are unreachable statements, loops not entered at 
the top, automatic variables declared and not used, and logical 
expressions whose value is constant. Moreover, the usage of func- 
tions is checked to find functions that return values in some places 
and not in others, functions called with varying numbers or types of 
arguments, and functions whose values are not used or whose 
values are used but none returned. 


Arguments whose names end with .c are taken to be C source files. 
Arguments whose names end with .In are taken to be the result of 
an earlier invocation of lint with either the -c or the -o option 
used. The .In files are analogous to .o (object) files that are pro- 
duced by the cc (7) command when given a .c file as input. Files 
with other suffixes are warned about and ignored. 


Lint will take all the .c , .In , and Ilib-lx.In (specified by —Ix) files 
and process them in their command line order. By default, fint 
appends the standard C lint library (Ilib-Ic.In) to the end of the list of 
files. However, if the -p option is used, the portable C lint library 
(Ilib-port.In) is appended instead. When the —c option is not used, 
the second pass of /int checks this list of files for mutual compatibil- 
ity. When the -c option is used, the .In and the Ilib-Ix.In files are 
ignored. 


Any number of lint options may be used, in any order, intermixed 
with file-name arguments. The following options are used to 
suppress certain kinds of complaints: 


—-a Suppress complaints about assignments of long values to 
variables that are not long. 


—b Suppress complaints about break statements that cannot 
be reached. (Programs produced by /ex or yacc will often 
result in many such complaints). 


—h Do not apply heuristic tests that attempt to intuit bugs, 
improve style, and reduce waste. 


—U Suppress complaints about functions and external variables 
used and not defined, or defined and not used. (This option 
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is suitable for running linf on a subset of files of a larger 
program). 


Suppress complaints about unused arguments in functions. 


Do not report variables referred to by external declarations 
but never used. 


The following arguments alter lint 's behavior: 


—lx 


-p 


-C 


—O lib 


Include additional lint library Iib-lx.In. For example, you 
can include a lint version of the Math Library Hib-!m.iIn by 
inserting —Im on the command line. This argument does 
not suppress the default use of Ilib-Ilc.ln . These lint 
libraries must be in the assumed directory. This option can 
be used to reference local lint libraries and is useful in the 
development of multi-file projects. 


Do not check compatibility against either the standard or the 
portable lint library. 


Attempt to check portability to other dialects (IBM and 
GCOS) of C. Along with stricter checking, this option causes 
all non-external names to be truncated to eight characters 
and all external names to be truncated to six characters and 
one case. 


Cause lint to produce a .In file for every .c file on the com- 
mand line. These .In files are the product of /int ’s first pass 
only, and are not checked for inter-function compatibility. 


Cause /int to create a lint library with the name Ilib-I//b.In. 
The —c option nullifies any use of the -o option. The lint 
library produced is the input that is given to /int ‘s second 
pass. The —o option simply causes this file to be saved in 
the named lint library. To produce a Ilib-I/ib.In without 
extraneous messages, use of the -x option is suggested. 
The —v option is useful if the source file(s) for the lint library 
are just external interfaces (for example, the way the file 
llib-ic is written). These option settings are also available 
through the use of “lint comments” (see below). 


The -D , -U , and -l options of cpp (7) and the -g and —O options 
of cc (1) are also recognized as separate arguments. The -g and 
-—QO options are ignored, but, by recognizing these options, fint ‘s 
behavior is closer to that of the cc (1) command. Other options are 
warned about and ignored. The pre-processor symbol ‘lint’ is 
defined to allow certain questionable code to be altered or removed 
for lint . Therefore, the symbol ‘lint’ should be thought of as a 
reserved word for all code that is planned to be checked by /int . 
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Certain conventional comments in the C source will change the 
behavior of lint - 


/* NOTREACHED#: 
at appropriate points stops comments about 
unreachable code. (This comment is_ typically 
placed just after calls to functions like exit (2)). 


/*VARARGSnN «i 
suppresses the usual checking for variable numbers 
of arguments in the following function declaration. 
The data types of the first m arguments are 
checked; a missing rn is taken to be 0. 


/* ARGSUSED*/ 
turns on the —v option for the next function. 


/* LINTLIBRARY */ 
at the beginning of a file shuts off complaints about 
unused functions and function arguments in this file. 
This is equivalent to using the -v and —-x options. 


Lint produces its first output on a per-source-file basis. Complaints 
regarding included files are collected and printed after all source 
files have been processed. Finally, if the -—c option is not used, 
information gathered from all input files is collected and checked for 
consistency. At this point, if it is not clear whether a complaint 
stems from a given source file or from one of its included files, the 
source file name will be printed followed by a question mark. 


The behavior of the -c and the —o options allows for incremental 
use of lint on a set of C source files. Generally, one invokes /int 
once for each source file with the —c option. Each of thesé invoca- 
tions produces a .In file which corresponds to the .c file, and prints 
all messages that are about just that source file. After all the source 
files have been separately run through /int , it is invoked once more 
(without the —c option), listing all the .In files with the needed -Ix 
options. This will print all the inter-file inconsistencies. This scheme 
works well with make (7); it allows make to be used to /int only the 
source files that have been modified since the last time the set of 
source files were /int ed. 


/usr/lio the directory where the lint libraries specified by 
the —Ix option must exist 

/usr/lib/lint{12] first and second passes 

/usr/lib/llib-Ic.In. declarations for C Library functions (binary format; 
source is in /usr/lib/Ilib-Ic ) 
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/usr/lib/llib-port.In declarations for portable functions (binary format; 
source is in /usr/lib/iib-port ) 

/usr/lib/ilib-Im.In declarations for Math Library functions (binary 
format; source is in /usr/lib/Ilib-lm ) 


/usr/tmp/slints temporaries 
SEE ALSO 
cc(1), cpp(1), make(1). 


BUGS 
exit (2), longjmp (3C), and other functions that do not return are not 
understood; this Causes various lies. 
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NAME 


login — sign on 


SYNOPSIS 


login [ name [ env-var ... ]] 


DESCRIPTION 
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The login command is used at the beginning of each terminal session 
and allows you to identify yourself to the system. It may be invoked 
aS a command or by the system when a connection is first esta- 
blished. Also, it is invoked by the system when a previous user has 
terminated the initial shell by typing a cntrl-d to indicate an ‘‘end-of- 
file.’ (See How to Get Started at the beginning of this volume for 
instructions on how to dial up initially.) 


lf login is invoked as a command it must replace the initial command 
interpreter. This is accomplished by typing: 

exec login 
from the initial shell. 


Login asks for your user name (if not Supplied as an argument), and, 
if appropriate, your password. Echoing is turned off (where possible) 
during the typing of your password, so it will not appear on the writ- 
ten record of the session. 


At some installations, an option may be invoked that will require you 
to enter a second ‘‘dialup’’ password. This will occur only for dial-up 
connections, and will be prompted by the message ‘“‘dialup pass- 
word:’’. Both passwords are required for a successful login. 


If you do not complete the login successfully within a certain period 
of time (e.g., one minute), you are likely to be silently disconnected. 


After a successful login, accounting files are updated, the procedure 
/etc/profile is performed, the message-of-the-day, if any, is printed, 
the user-ID, the group-!ID, the working directory, and the command 
interpreter (usually sh (1)) is initialized, and the file .profile in the 
working directory is executed, if it exists. These specifications are 
found in the /etc/passwd file entry for the user. The name of the 
command interpreter is — followed by the last component of the 
interpreter’s pathname (i.e., —sh ). If this field in the password file is 
empty, then the default command interpreter, /bin/sh is used. lf this 
field is ‘**’’, then a chroot (2) is done to the directory named in the 
directory field of the entry. At that point /ogin is re-executed at the 
new level which must have its own root structure, including 
/etc/login and /etc/passwd. 
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The basic environment (see environ (5)) is initialized to: 


HOME=your-login-directory 
PATH=:/bin:/usr/bin 
SHELL=/ast-field-of-passwa-entry 
MAIL=/usr/mail/your-login-name 
TZ=timezone-specification 


The environment may be expanded or modified by supplying addi- 
tional arguments to /ogin, either at execution time or when login 
requests your login name. The arguments may take either the form 
XXX Or xxx=yyy. Arguments without an equal sign are placed in the 
environment as 

Ln=xxx 
where n is a number starting at O and is incremented each time a 
new variable name is required. Variables containing an = are placed 
into the environment without modification. If they already appear in 
the environment, then they replace the older value. There are two 
exceptions. The variables PATH and SHELL cannot be changed. This 
prevents people, logging into restricted shell environments, from 
spawning secondary shells which are not restricted. Both /ogin and 
getty understand simple single-character quoting conventions. Typ- 
ing a backslash in front of a character quotes it and allows the inclu- 
sion of such things as Spaces and tabs. 


FILES 
/etc/utmp accounting 
/etc/wtmp accounting 
/usr/mail/your-name mailbox for user your-name 
/etc/motd message-of-the-day 
/etc/passwd password file 
/etc/profile system profile 
/etc/d_passwd dialup password file 
/etc/dialups list of dialups 
.profile user’s login profile 

SEE ALSO 


mail(1), newgrp(1), sh(1), su(1). 
d_passwd(4), dialups(4), passwd(4), profile(4), environ(5) in the Sys5 
UNIX Programmer Reference Manual. 


DIAGNOSTICS 
Login incorrect if the user name or the password cannot be matched. 
No shell, cannot open password file, or no directory: consult a UNIX 
system programming counselor. 
No utmp entry. You must exec "login" from the lowest level "sh". if you 
attempted to execute /ogin as a command without using the shell’s 
exec internal command or from other than the initial shell. 
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NAME 
logname — get login name 


SYNOPSIS 
logname 


DESCRIPTION 
Logname returns the contents of the environment variable $LOGNAME, 
which is set when a user logs into the system. 


FILES 
/etc/profile 
SEE ALSO 
env(1), login(1). 
logname(3X), environ(5) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 

lorder — find ordering relation for an object library 
SYNOPSIS 

lorder file ... 


DESCRIPTION 

The input is one or more object or library archive files (see ar (7)). 
The standard output is a list of pairs of object file names, meaning 
that the first file of the pair refers to external identifiers defined in the 
second. The output may be processed by tsort (1) to find an order- 
ing of a library suitable for one-pass access by /d (7). Note that the 
link editor /d (7) is capabie of multiple passes over an archive in the 
portable archive format (see ar (4)) and does not require that /order 
(1) be used when building an archive. The usage of the /order (7) 
command may, however, allow for a slightly more efficient access of 
the archive during the link edit process. 


The following example builds a new library from existing .o files. 


ar cr library * lorder *.o | tsort* 


FILES 

*«symref, «symdef temporary files 
SEE ALSO 

ar(1), Id(1), tsort(1). 

ar(4) in the Sys5 UNIX Programmer Reference Manual. 
BUGS 


Object files whose names do not end with .o , even when contained 
in library archives, are overlooked. Their global symbols and refer- 
ences are attributed to some other file. 
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lp, cancel — send/cancel requests to an LP line printer 


SYNOPSIS 


Ip [-c] [-ddest] [-—m] [—nnumber] [—ooption] [-s] [-ttitle] [-w] 
files 
cancel [ids] [printers ] 


DESCRIPTION 
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Lp arranges for the named files and associated information (collec- 
tively called a request ) to be printed by a line printer. If no file 
names are mentioned, the standard input is assumed. The file 
name — stands for the standard input and may be supplied on the 
command line in conjunction with named files . The order in which 
files appear is the same order in which they will be printed. 


Lp associates a unique jd with each request and prints it on the 
standard output. This id can be used later to cancel (see cancel ) 
or find the status (see /pstat (1)) of the request. 


The following options to /o may appear in any order and may be 
intermixed with file names: 


—C Make copies of the files to be printed immediately when 
[p is invoked. Normally, files will not be copied, but will 
be linked whenever possible. If the -—c option is not 
given, then the user should be careful not to remove any 
of the files before the request has been printed in its 
entirety. It should also be noted that in the absence of 
the -—c option, any changes made to the named files 
after the request is made but before it is printed will be 
reflected in the printed output. 


-—ddest Choose dest as the printer or class of printers that is to 
do the printing. If dest is a printer, then the request will 
be printed only on that specific printer. If dest is a class 
of printers, then the request will be printed on the first 
available printer that is a member of the class. Under 
certain conditions (printer unavailability, file space limita- 
tion, etc.), requests for specific destinations may not be 
accepted (see accept (1M) and /pstat (1)). By default, 
dest is taken from the environment variable LPDEST (if it 
is set). Otherwise, a default destination (if one exists) 
for the computer system is used. Destination names 
vary between systems (see /pstat (7 )). 


—m Send mail (see mail(1)) after the files have been 
printed. By default, no mail is sent upon normal comple- 
tion of the print request. 
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—nnumber Print number copies (default of 1) of the output. 


Specify printer-dependent or class-dependent options . 
Several such options may be collected by specifying the 
-—o keyletter more than once. For more information 
about what is valid for options , see Models in lpadmin 
(1M). 


Suppress messages from /p (7) such as "request id is 


Print title on the banner page of the output. 


Write a message on the user's terminal after the files 
have been printed. If the user is not logged in, then mail 
will be sent instead. 


Cance/ cancels line printer requests that were made by the /p (7) 
command. The command line arguments may be either request ids 
(as returned by /p (7)) or printer names (for a complete list, use 
lpstat (1)). Specifying a request id cancels the associated request 
even if it is currently printing. Specifying a printer cancels the 
request which is currently printing on that printer. In either case, the 
cancellation of a request that is currently printing frees the printer to 
print its next available request. 


enable(1), Ipstat(1), mail(1). 
accept(1M), lpadmin(1M), lpsched(1M) in the "Sys5 UNIX Adminis- 
trator Reference Manual" . 


LP(1) 
—ooption 
—S 
—ttitle 
—W 
FILES 
/ust/spool/lp/* 
SEE ALSO 
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NAME 
lphold, Ilprun — postpone printing, resume printing 


SYNOPSIS 
/usr/bin/Iphold [ id ] 


/usr/bin/Iprun [ id | 


DESCRIPTION 
Lphold postpones the printing of the request whose request identifi- 
cation is id until an /orun command is received for that request. 
Lprun causes resumption of printing of the request whose identifi- 
cation number is id, which was previously put on hold by the /phold 
command. The request is placed last in the queue. 


SEE ALSO 
accept(1m), lpadmin(1m), lIpsched(1m), 
enable(1), Ip(1), lpstat, in the Sys5 UNIX User’s Reference Manual. 
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NAME 


lpstat — print LP status information 


SYNOPSIS 


Ipstat [ options | 


DESCRIPTION 
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Lpstat prints information about the current status of the LP line 
printer system. 


If no options are given, then /pstat prints the status of all requests 
made to /p (7) by the user. Any arguments that are not options are 
assumed to be request fds (as returned by /p ). Lpstat prints the 
status of such requests. Options may appear in any order and may 
be repeated and intermixed with other arguments. Some of the 
keyletters below may be followed by an optional /ist that can be in 
one of two forms: a list of items separated from one another by a 
comma, or a list of items enclosed in double quotes and separated 
from one another by a comma and/or one or more spaces. For 
example: 


—u"userl, user2, user3” 


The omission of a fist following such keyletters causes ail informa- 
tion relevant to the keyletter to be printed, for example: 


lpstat —o 
prints the status of all output requests. 


—a[list] Print acceptance status (with respect to /p ) of destina- 
tions for requests. List is a list of intermixed printer 
names and class names. 


—c [fist] Print class names and their members. List is a list of 
class names. 


—d Print the system default destination for /p . 


—O [/ist] Print the status of output requests. List is a list of inter- 
mixed printer names, class names, and request /ds . 


-—p [/ist] Print the status of printers. List Is a list of printer names. 
—r Print the status of the LP request scheduler 


a) Print a status summary, including the status of the line 
printer scheduler, the system default destination, a list of 
class names and their members, and a list of printers and 
their associated devices. 


—t Print all status information. 


—u [/ist] Print status of output requests for users. List is a list of 
login names. 
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-v [/ist] Print the names of printers and the pathnames of the dev- 
ices associated with them. List is a list of printer names. 


FILES 


/ust/spool/|p/* 


SEE ALSO 
enable(1), |p(1). 
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NAME 
Is — list contents of directories 


SYNOPSIS 
Is [ -RadCxmnlogrtucpFbqisf | names 


DESCRIPTION 

For each directory named, /s lists the contents of that directory; for 
each file named, /s repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several 
arguments are given, the arguments are first sorted appropriately, 
but file arguments are processed before directories and their con- 
tents. There are several options: 


—-R Recursively list subdirectories encountered. 

—a List all entries; in the absence of this option, entries whose 
names begin with a period (.) are not listed. 

—d lf argument is a directory, list only its name; often used with 
—| to get the status of a directory. 

—C Multi-column output with entries sorted down the columns. 

—X Multi-column output with entries sorted across, rather than 


down, the columns. 


—m Stream output format. That is, entries separated by comma 
and space rather than by newline. 


—I List in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each 
file (see below). If a special file, the size field will contain 
the major and minor device numbers, rather than a size. 


—n The same as -l, except that owner’s UID and group’s GID 
numbers are printed, rather than the associated character 
strings. 

—O The same as -I , except that the group is not printed. 

-—g The same as -I , except that the owner is not printed. 

—r Reverse the order of sort to get reverse alphabetic or oldest 
first, aS appropriate. 

—t Sort by time of last modification (latest first) instead of by 
name. 

—u Use time of last access instead of last modification for sort- 
ing (with the —t option) and/or printing (with the —I option). 

—C Use time of last modification of the inode (mode, etc.) 
instead of last modification of the file for sorting (—t) and/or 
printing (—I). 
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Put a slash (/) after each filename if that file is a directory. 


Put a slash (/) after each filename if that file is a directory, 
and put an asterisk (*) after each filename if that file is exe- 
cutable. 


Force printing of non-graphic characters to be in the octal 
/ddd notation. 


Force printing of non-graphic characters in the file names as 
the character (7). 


For each file, print the i-number in the first column of the 
report. 


Give size in 1024-byte blocks (including indirect blocks) for 
each entry. 


Force each argument to be interpreted as a directory and 
list the name found in each slot. This option turns off -I, -t, 
-—S, and —-r, and turns on —a; the order is the order in which 
entries appear in the directory. 


The mode printed under the —| option consists of 10 characters that 
are interpreted as follows: 


The first character is: 


d__ if the entry ts a directory; 

b if the entry is a block special file; 

cif the entry is a character special file; 

p if the entry is a fifo (a.k.a. “named pipe’) spe- 

cial file; 

— if the entry is an ordinary file. 
The next 9 characters are interpreted as three sets of three 
bits each. The first set refers to the owner’s permissions; 
the next to permissions of others in the user-group of the 
file; and the last to all others. Within each set, the three 
characters indicate permission to read, to write, and to exe- 
cute the file as a program, respectively. For a directory, 
“execute” permission is interpreted to mean permission to 
search the directory for a specified file. 


The permissions are indicated as follows: 


r if the file is readable; 

w if the file is writable; 

x if the file is executable; 

- if the indicated permission is not granted. 


The group-execute permission character is given as s if the 
file has set-group-ID mode; likewise, the user-execute per- 
mission character is given as s if the file has set-user-ID 
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mode. The last character of the mode (normally x or —) ist 
aoe if the 1000 (octal) bit of the mode is on; see chmod (1) for 
( the meaning of this mode. The indications of set-ID and 
1000 bit of the mode are capitalized if the corresponding 

execute permission is not set. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is printed. 


FILES 
/etc/passwd to get user IDs for Is —I and Is -o . 
/etc/group to get group IDs for Is —-I and Is -g . 


NOTES 
Plexus provides a standalone version of /s in addition to the one that 
runs under Sys5. 


SEE ALSO 
chmod(1), find(1). 


BUGS 
The ‘“-g” and “-o” options are incompatible. 
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m4 — macro processor 


SYNOPSIS 


m4 [ options | [ files ] 


DESCRIPTION 
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M4 is a macro processor intended as a front end for Ratfor, C, and 
other languages. Each of the argument files is processed in order; 
if there are no files, or if a file name is — , the standard input is read. 
The processed text is written on the standard output. 


The options and their effects are as follows: 


—~e Operate interactively. Interrupts are ignored and the output 
is unbuffered. 


-S Enable line sync output for the C preprocessor (#line ...) 


—Bint Change the size of the push-back and argument collection 
buffers from the default of 4,096. 


—Hint Change the size of the symbol table hash array from the 
default of 199. The size should be prime. 


-Sint Change the size of the call stack from the default of 100 
slots. Macros take three slots, and non-macro arguments 
take one. 


-Tint Change the size of the token buffer from the default of 512 
bytes. 


To be effective, these flags must appear before any file names and 
before any —D or —-U flags: 
—Dname|[ = val] 

Defines name to val or to null in va/ ‘s absence. 


—Uname 
undefines name . 


Macro calls have the form: 
name(argt,arg2, ..., argn) 


The ( must immediately follow the name of the macro. If the name 
of a defined macro is not followed by a (, it is deemed to be a call 
of that macro with no arguments. Potential macro names consist of 
alphabetic letters, digits, and underscore _ , where the first charac- 
ter is not a digit. 
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Leading unquoted blanks, tabs, and new-lines are ignored while col- 
lecting arguments. Left and right single quotes are used to quote 
strings. The value of a quoted string is the string stripped of the 
quotes. 


When a macro name is recognized, its arguments are collected by 
searching for a matching right parenthesis. If fewer arguments are 
supplied than are in the macro definition, the trailing arguments are 
taken to be null. Macro evaluation proceeds normally during the 
collection of the arguments, and any commas or right parentheses 
which happen to turn up within the value of a nested call are as 
effective as those in the original input text. After argument collec- 
tion, the value of the macro is pushed back onto the input stream 
and rescanned. 


M4 makes available the following built-in macros. They may be 
redefined, but once this is done the original meaning is lost. Their 
values are null unless otherwise stated. 


define the second argument is installed as the value of the 
macro whose name is the first argument. Each 
occurrence of $n in the replacement text, where rn is a 
digit, is replaced by the n -th argument. Argument 0 is 
the name of the macro; missing arguments are 
replaced by the null string; $# is replaced by the 
number of arguments; $* is replaced by a list of all the 
arguments separated by commas; $@ is like $* , but 
each argument is quoted (with the current quotes). 


undefine removes the definition of the macro named in its argu- 
ment. 

defn returns the quoted definition of its argument(s). It is 
useful for renaming macros, especially built-ins. — 

pushdef like define , but saves any previous definition. 

popdef removes current definition of its argument(s), exposing 


the previous one, if any. 


ifdef if the first argument is defined, the value is the second 
argument, otherwise the third. If there is no third argu- 
ment, the value is null. The word unix is predefined 
on UNIX system versions of m4. 


shift returns all but its first argument. The other arguments 
are quoted and pushed back with commas in between. 
The quoting nullifies the effect of the extra scan that 
will subsequently be performed. 
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changequote 
change quote symbols to the first and second argu- 
ments. The symbols may be up to five characters 
long. Changequote without arguments restores the 
Original values (1.e., > *). 


changecom change left and right comment markers from the 
default # and new-line. With no arguments, the com- 
ment mechanism is effectively disabled. With one 
argument, the left marker becomes the argument and 
the right marker becomes new-line. With two argu- 
ments, both markers are affected. Comment markers 
may be up to five characters long. 


divert m4 maintains 10 output streams, numbered 0-9. The 
final output is the concatenation of the streams in 
numerical order; initially stream O is the current 
stream. The divert macro changes the current output 
stream to its (digit-string) argument. Output diverted 
to a stream other than 0 through 9 is discarded. 


undivert Causes immediate output of text from diversions 
named as arguments, or all diversions if no argument. 
Text may be undiverted into another diversion. 
Undiverting discards the diverted text. 


divnum returns the value of the current output stream. 


dni reads and discards characters up to and including the 
| next new-line. 


ifelse has three or more arguments. If the first argument is 
the same string as the second, then the value is the 
third argument. If not, and if there are more than four 
arguments, the process is repeated with arguments 4, 
5, 6 and 7. Otherwise, the value is either the fourth 
string, or, if it is not present, null. 


incr returns the value of its argument incremented by 1. 
The value of the argument is calculated by interpreting 
an initial digit-string as a decimal number. 


decr returns the value of its argument decremented by 1. 
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eval 


len 


index 


substr 


translit 


include 


sinclude 


syscmd 


sysval 


maketemp 


m4exit 


m4wrap 


errprint 


dumpdef 


traceon 
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evaluates its argument as an arithmetic expression, 
using 32-bit arithmetic. Operators include + ,-,*,/ 
, % , ~ (exponentiation), bitwise & , |, ~ , and ~ ; rela- 
tionals; parentheses. Octal and hex numbers may be 
specified as in C. The second argument specifies the 
radix for the result; the default is 10. The third argu- 
ment may be used to specify the minimum number of 
digits in the result. 


returns the number of characters in its argument. 


returns the position in its first argument where the 
second argument begins (zero origin), or —1 if the 
second argument does not occur. 


returns a substring of its first argument. The second 
argument is a zero origin number selecting the first 
character; the third argument indicates the length of 
the substring. A missing third argument is taken to be 
large enough to extend to the end of the first string. 


transliterates the characters in its first argument from 
the set given by the second argument to the set given 
by the third. No abbreviations are permitted. 


returns the contents of the file named in the argument. 


is identical to include , except that it says nothing if the 
file is inaccessible. 


executes the UNIX system command given in the first 
argument. No value is returned. 


is the return code from the last call to syscmd . 


fills in a string of XXXXX in its argument with the 
current process ID. 


Causes immediate exit from m4. Argument 1, if given, 
is the exit code; the default is 0. 


argument 1 will be pushed back at final EOF; example: 
m4wrap(* cleanup( ) *) 


prints its argument on the diagnostic output file. 


prints current names and definitions, for the named 
items, or for all if no arguments are given. 


with no arguments, turns on tracing for all macros 
(including built-ins). Otherwise, turns on tracing for 
named macros. 
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traceoff turns off trace globally and for any macros specified. 
Macros specifically traced by traceon can be untraced 
only by specific calls to traceoff . 


SEE ALSO 
cc(i), cpp(1). 


The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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NAME 
macref — produce cross-reference listing of macro files 


SYNOPSIS 
macref [-t] [-s] [—n] file ... 


DESCRIPTION 
The macref program reads the named files (which are assumed to 
be nroff(1)/troff(1) input) and produces a cross-reference listing of 
the symbols in the input. 


A -t in the command line causes a macro table of contents to be 
printed. A —S causes symbol use statistics to be output. 


The default output is a list of the symbols found in the input, each 
accompanied by a list of all references to that symbol. (This output | 
may be defeated by using a —n in the command line). The symbols 
are listed alphabetically in the leftmost column, with the references 
following to the right. Each reference is given in the form: 


[ (NMname)]| Mname—]} type Inum [#] 


where the fields have the following meanings: 


Mname_ the name of the macro within which the reference occurs. 
This field is missing if the reference occurs at the text 
level. Any names listed in the NMname part are macros 
within which Mname is defined. 


type the type associated, by context, with this occurrence of 
the symbol. The types may be: 
r request 
m macro 
d diversion 
Ss string 
n number register 
p parameter (e.g. \$x is a parameter reference to x. 


Note that parameters are never modified, and that 
the only valid parameter symbol names are 1, 2, ... 


9). 
num the line number on which the reference occurred. 
# this reference modifies the value of the symbol. 


Generated names are listed under the artificial symbol name 


” 


sym”. 


it~ 


SEE ALSO 
nroff(1), troff(1). 
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mail, rmail — send mail to users or read mail 


SYNOPSIS 
mail [ -epqr | [ —f file ] 


mail [ -t ] persons 


rmail [ -t ] persons 


Mail without arguments prints a user’s mail, message-by-message, 
in last-in, first-out order. For each message, the user is prompted 
with a ?, and a line is read from the standard input to determine the 
disposition of the message: 


<new-line> Go on to next message. 

t Same as <new-line>. 

d Delete message and go on to next mes- 
sage. 

p Print message again. 

_ Go back to previous message. 

s [ files | Save message in the named files (mbox 
is default). 

w [ files | Save message, without its header, in the 


named files (mbox is default). 
m [ persons |] Mail the message to the named persons 
(yourself is default). 


q Put undeleted mail back in the maiffile 
and stop. 

EOT (control-d) Same as q. 

x Put all mail back in the mai/file unchanged 
and stop. 

command Escape to the shell to do command. 

* Print a command summary. 


The optional arguments alter the printing of the mail: 


—e 


-p 


-q 


-r 
—ffile 


Causes mail not to be printed. An exit value of 0 is returned 
if the user has mail; otherwise, an exit value of 1 is 
returned. 

causes all mail to be printed without prompting for disposi- 
tion. 

Causes mail to terminate after interrupts. Normally an inter- 
rupt only causes the termination of the message being 
printed. 

causes messages to be printed in first-in, first-out order. 
causes mail to use file (e.g., mbox) instead of the default 
mailfile. 
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When persons are named, mail takes the standard input up to an 
end-of-file (or up to a line consisting of just a .) and adds it to each 
person's mailfile. The message is preceded by the sender's name 
and a postmark. Lines that look like postmarks in the message, ~~. 
(i.e., “From...”) are preceded with a >. The -—t option causes the 
message to be preceded by all persons the mail is sent to. A per- 
son is usually a user name recognized by fogin(1). If a person 
being sent mail is not recognized, or if mai! is interrupted during 
input, the file dead.letter will be saved to allow editing and resend- 
ing. Note that this is regarded as a temporary file in that it is 
recreated every time needed, erasing the previous contents of 
dead. letter. 


To denote a recipient on a remote system, prefix person by the sys- 
tem name and exclamation mark (see uucp(1C)). Everything after 
the first exclamation mark in persons is interpreted by the remote 
system. In particular, if persons contains additional exclamation 
marks, it can denote a sequence of machines through which the 
message is to be sent on the way to its ultimate destination. For 
example, specifying alb!cde as a recipient’s name causes the mes- 
sage to be sent to user b!cde on system a. System a will interpret 
that destination as a request to send the message to user cde on 
system b. This might be useful, for instance, if the sending system 
can access system a but not system b, and system a has access to 
system b. Mail will not use uucp if the remote system is the local \ 
system name (i.e., localsystem!user). 


The mailfile may be manipulated in two ways to alter the function of 
mail. The other permissions of the file may be read-write, read- 
only, or neither read nor write to allow different levels of privacy. If 
changed to other than the default, the file will be preserved even 
when empty to perpetuate the desired permissions. The file may 
also contain the first line: 


Forward to person 


which will cause all mail sent to the owner of the mailfile to be for- 
warded to person. This is especially useful to forward all of a 
person's mail to one machine in a multiple machine environment. In 
order for forwarding to work properly the mailfile should have "mail" 
as group ID, and the group permission should be read-write. 


Rmail only permits the sending of mail; uucp(1C) uses rmail as a 
security precaution. 


When a user logs in, the presence of mail, if any, is indicated. Also, 
notification is made if new mail arrives while using mail. 
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FILES 
/etc/passwd to identify sender and locate persons 
/usr/Mail/user incoming mail for user; i.e., the maiffile 
$SHOME/mbox saved mail 
$MAIL variable containing path name of maiifile 
/tmp/max temporary file 
/ust/mail/*.lock lock for mail directory 
dead.letter unmailable text 

SEE ALSO 
login(1), mailx(1), uucp(1C), write(1). 

BUGS 


Conditions sometimes result in a failure to remove a lock file. 
After an interrupt, the next message may not be printed; printing 
may be forced by typing a p. 
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NAME 


mailx — interactive message processing system 


SYNOPSIS 


mailx [options] [name...] 


DESCRIPTION 


Page 1 


The command mailx provides a comfortable, flexible environment for 
sending and receiving messages electronically. When reading mail, 
mailx provides commands to facilitate saving, deleting, and respond- 
ing to messages. When sending mail, mailx allows editing, review- 
ing and other modification of the message as it is entered. 


Incoming mail is stored in a standard file for each user, called the 
system mailbox for that user. When mai/x is called to read mes- 
sages, the mailbox is the default place to find them. As messages 
are read, they are marked to be moved to a secondary file for 
storage, unless specific action is taken, so that the messages need 
not be seen again. This secondary file is called the mbox and is 
normally located in the user's HOME directory (see "MBOX" 
(ENVIRONMENT VARIABLES) for a description of this file). Messages 
remain in this file until forcibly removed. 


On the command line, options start with a dash (—) and any other 
arguments are taken to be destinations (recipients). If no recipients 


are specified, mai/x will attempt to read messages from the mailbox. 


Command line options are: 


—d Turn on debugging output. Neither particu- 
larly interesting nor recommended. 
—e Test for presence of mail. Mailx prints noth- 


ing and exits with a successful return code if 
there is mail to read. 

-f [filename] Read messages from filename instead of 
mailbox. If no filename is specified, the 
mbox is used. 

—F Record the message in a file named after 
the first recipient. Overrides the "record" 
variable, if set (See ENVIRONMENT VARI- 

| ABLES). 

-—h number — The number of network "hops" made so far. 
This is provided for network software to 
avoid infinite delivery loops. 

—H Print header summary only. 

i Ignore interrupts. See also "ignore" 
(ENVIRONMENT VARIABLES). 
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—n Do not initialize from the system default _ - 
Mailx.rc file. ( | 
-N Do not print initial header summary. Se 


-—r address Pass address to network delivery software. 
All tilde commands are disabled. 
~—s subject Set the Subject header field to subject . 


—u user Read user ’s mailbox. This is only effective 
if user ’s mailbox is not read protected. 
—U Convert uucp style addresses to internet 


standards. Overrides the "conv" environ- 
ment variable. 


When reading mail, mai/x is in command mode. A header summary 
of the first several messages is displayed, followed by a prompt indi- 
cating mailx can accept regular commands (see COMMANDS below). 
When sending mail, mai/x is in input mode. If no subject is speci- 
fied on the command line, a prompt for the subject is printed. As 
the message is typed, mai/x will read the message and store it in a 
temporary file. Commands may be entered by beginning a line with 
the tilde (") escape character followed by a single command letter 
and optional arguments. See TILDE ESCAPES for a summary of 
these commands. 


At any time, the behavior of mai/x is governed by a set of environ- 
ment variables. These are flags and valued parameters which are 
set and cleared via the se t and uns et commands. See ENVIRON- 
MENT VARIABLES below for a summary of these parameters. 


Recipients listed on the command line may be of three types: login 
names, shell commands, or alias groups. Login names may be any 
network address, including mixed network addressing. If the reci- 
pient name begins with a pipe symbol (|, the rest of the name is 
taken to be a shell command to pipe the message through. This 
provides an automatic interface with any program that reads the 
standard input, such as /p (7) for recording outgoing mail on paper. 
Alias groups are set by the a lias command (see COMMANDS 
below) and are lists of recipients of any type. 


Regular commands are of the form 


[ command ]| [ msg/ist | [ argu- 
ments | 
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If no command is specified in command mode, p rint is assumed. 
In input mode, commands are recognized by the escape character, 
and lines not treated as commands are taken as input for the mes- 
sage. 


Each message is assigned a sequential number, and there is at any 
time the notion of a ‘current’ message, marked by a ‘>’ in the 
header summary. Many commands take an optional list of mes- 
sages (msqglist) to operate on, which defaults to the current mes- 
sage. A msglist is a list of message specifications separated by 
Spaces, which may include: 


n Message numbern. 
The current message. 

The first undeleted message. 

$ The last message. 
oe All messages. 

n—-m An inclusive range of message numbers. 

user All messages from user . 

‘string All messages with string in the subject line (case 


a 


ignored). 
c All messages of type c , where c is one of: 
d deleted messages 
n new messages 
O old messages 
r read messages 
u unread messages 


Note that the context of the command determines 
whether this type of message specification makes 
sense. 


Other arguments are usually arbitrary strings whose usage depends 
on the command involved. File names, where expected, are 
expanded via the normal shell conventions (see sh (7)). Special 
characters are recognized by certain commands and are docu- 
mented with the commands below. 


At start-up time, mailx reads commands from a system-wide file 
(/usr/lib/mailx/mailx.rc) to initialize certain parameters, then from a 
private start-up file (SHOME/.mailrc) for personalized variables. 
Most regular commands are legal inside start-up files, the most 
common use being to set up initial display options and alias lists. 
The following commands are not legal in the start-up file: !, C opy, 
e dit, fo Ilowup, F ollowup, ho Id, m ail, pre serve, r eply, R eply, 
sh ell, and v isual. Any errors in the start-up file cause the remain- 
ing lines in the file to be ignored. 
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COMMANDS 
The following is a complete list of mail/x commands: 


Ishell-command 
Escape to the shell. See "SHELL" (ENVIRONMENT VARI- 
ABLES). 


# comment 
Null command (comment). This may be useful in .maiirc 
files. 


Print the current message number. 


Prints a summary of commands. 


alias alias name ... 

group alias name ... 
Declare an alias for the given names. The names will be 
substituted when alias is used as a recipient. Useful in the 
.maiirc file. 


alternates name ... 
Declares a list of alternate names for your login. When 
responding to a message, these names are removed from 
the list of recipients for the response. With no arguments, 
alt ernates prints the current list of alternate names. See 
also “allnet” (ENVIRONMENT VARIABLES). 


cd [directory] 

chdir [directory] 
Change directory. lf directory is not specified, $HOME is 
used. 


copy [filename] 

copy [msglist]| filename 
Copy messages to the file without marking the messages as 
saved. Otherwise equivalent to the s ave command. 


Copy [msgiist] 
Save the specified messages in a file whose name is 
derived from the author of the message to be saved, 
without marking the messages as saved. Otherwise 
equivalent to the S ave command. 
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delete [msglist] 


Delete messages from the mai/box. If “autoprint” is set, the 
next message after the last one deleted is printed (see 
ENVIRONMENT VARIABLES). 


discard [header-field ...| 
ignore [header-field ...] 


Suppresses printing of the specified header fields when 
displaying messages on the screen. Examples of header 
fields to ignore are 'status” and "cc." The fields are included 
when the message is saved. The P rint and T ype com- 
mands override this command. 


dp [msglist] 
dt [msgiist| 


Delete the specified messages from the mailbox and print 
the next message after the last one deleted. Roughly 
equivalent to a d elete command followed by a p rint com- 
mand. 


echo string ... 


Echo the given strings (like echo (7)). 


edit [msglist] 


exit 
xit 


Edit the given messages. The messages are placed in a 
temporary file and the "EDITOR" variable is used to get the 
name of the editor (see ENVIRONMENT VARIABLES). 
Default editor is ed (7). 


Exit from mailx, without changing the mailbox. No mes- 
sages are saved in the mbox (see also q uit). 


file [filename] 
folder [filename] 


Quit from the current file of messages and read in the speci- 
fied file. Several special characters are recognized when 
used as file names, with the following substitutions: 
% the current mai/box. 
%user 
the mailbox for user . 
# the previous file. 
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& the current mbox. 


Default file is the current mailbox. 


folders 


Print the names of the files in the directory set by the 
"folder" variable (see ENVIRONMENT VARIABLES). 


followup [message] 


Respond to a message, recording the response in a file 
whose name is derived from the author of the message. 
Overrides the "record" variable, if set. See also the F 
ollowup, S ave, and C opy commands and "outfolder’ 
(ENVIRONMENT VARIABLES). 


Followup [msgiist] 


Respond to the first message in the msglist, sending the 
message to the author of each message in the msgiist. The 
subject line is taken from the first message and the 
response is recorded in a file whose name is derived from 
the author of the first message. See also the fo llowup, S 
ave, and C opy commands and "outfolder" (ENVIRONMENT 
VARIABLES). 


from [msglist] 


Prints the header summary for the specified messages. 


group alias name ... 
alias alias name ... 


Declare an alias for the given names. The names will be 
substituted when alias is used as a recipient. Useful in the 
.mailrc file. 


headers [message] 


help 


Prints the page of headers which includes the message 
specified. The “screen” variable sets the number of 
headers per page (see ENVIRONMENT VARIABLES). See 
also the z command. 


Prints a summary of commands. 


hold [msglist] 
preserve [msglist] 
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if sy 

mail-commands 

else 

mail-commands 

endif 
Conditional execution, where s will execute following mail- 
commands, up to an el se or en dif, if the program is in 
send mode, and r causes the mail-commands to be exe- 
cuted only in receive mode. Useful in the .maiirc file. 


ignore header-field ... 

discard header-field ... 
Suppresses printing of the specified header fields when 
displaying messages on the screen. Examples of header 
fields to ignore are "status" and "cc." All fields are included 
when the message is saved. The P rint and T ype com- 
mands override this command. 


list 
Prints all commands available. No explanation is given. 


mail name ... 
Mail a message to the specified users. 


mbox [msglist| 
Arrange for the given messages to end up in the standard 
mbox save file when mailx terminates normally. See 
"MBOX" (ENVIRONMENT VARIABLES) for a description of 
this file. See also the ex it and q uit commands. 


next [message] 

Go to next message matching message. A msglist may be 
specified, but in this case the first valid message in the list 
is the only one used. This is useful for jumping to the next 
message from a specific user, since the name would be 
taken as a command in the absence of a real command. 
See the discussion of msglists above for a description of 
possible message specifications. 


pipe [msglist] [shell-commanda] 

| [msglist] [shell-command] 
Pipe the message through the given shell-command. The 
message is treated as if it were read. If no arguments are 
given, the current message is piped through the command 
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specified by the value of the "cmd" variable. If the "page" 
variable is set, a form feed character is inserted after each 
message (See ENVIRONMENT VARIABLES). 


preserve [msglisf] 
hold [msgiis¢] 
Preserve the specified messages in the mai/box. 


Print [msglist] 

Type [msglist] 
Print the specified messages on the screen, including all 
header fields. Overrides suppression of fields by the ig 
nore command. 


print [msqgiist] 

type [msgiist| 
Print the specified messages. If “crt” is set, the messages 
longer than the number of lines specified by the "crt" vari- 
able are paged through the command specified by the 
"PAGER" variable. The default command is pg (1) (see 
ENVIRONMENT VARIABLES). 


quit 
Exit from mai/x, storing messages that were read in mbox 
and unread messages in the mailbox. Messages that have 
been explicitly saved in a file are deleted. 


Reply [msgiist] 

Respond [msglist] 
Send a response to the author of each message in the 
msqglist. The subject line is taken from the first message. If 
"record" is set to a filename, the response is saved at the 
end of that file (see ENVIRONMENT VARIABLES). | 


reply [message] 

respond [message] 
Reply to the specified message, including all other reci- 
pients of the message. If "record" is set to a filename, the 
response is saved at the end of that file (see ENVIRONMENT 
VARIABLES). 


Save [msg/ist] 


save the specified messages in a file whose name is 
derived from the author of the first message. The name of 


May 27, 1985 Page 8 


MAILX(1) UNIX Sys5 MAILX(1) 


the file is taken to be the author's name with all network 
addressing stripped off. See also the C opy, fo llowup, 
and F ollowup commands and “outfolder" (ENVIRONMENT 
VARIABLES). 


save [filename] 

save [msglist] filename 
Save the specified messages in the given file. The file is 
created if it does not exist. The message is deleted from 
the mailbox when maix terminates unless "keepsave" is set 
(see also ENVIRONMENT VARIABLES and the ex it and q uit 
commands). 


set 

set name 

set name =string 

set name =number 
Define a variable called name. The variable may be given a 
null, string, or numeric value. Se t by itself prints all defined 
variables and their values. See ENVIRONMENT VARIABLES 
for detailed descriptions of the mai/x variables. 


shell 
Invoke an interactive shell (see also “SHELL” (ENVIRON- 
MENT VARIABLES)). | | 


size [msglist] 
Print the size in characters of the specified messages. 


source filename 
Read commands from the given file and return to command 
mode. 


top [msglist] 
Print the top few lines of the specified messages. If the 
“toplines" variable is set, it is taken as the number of lines to 
print (See ENVIRONMENT VARIABLES). The default is 5. 


touch [msglist] 
Touch the specified messages. If any message in msgliist is 
not specifically saved in a file, it will be placed in the mbox 
upon normal termination. See ex it and q uit. 
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Type [msgiist] 

Print [msglist] | 
Print the specified messages on the screen, including all 
header fields. Overrides suppression of fields by the ig 
nore command. 


type [msglist] 

print [msglist] 
Print the specified messages. If "crt" is set, the messages 
longer than the number of lines specified by the "crt" vari- 
able are paged through the command specified by the 
"PAGER" variable. The default command is pg (7) (see 
ENVIRONMENT VARIABLES). 


undelete [msgliist] 
Restore the specified deleted messages. Will only restore 
messages deleted in the current mail session. If "autoprint” 
is set, the last message of those restored is printed (see 
ENVIRONMENT VARIABLES). 


unset name ... 
Causes the specified variables to be erased. If the variable 
was imported from the execution environment (i.e., a shell 
variable) then it cannot be erased. 


version 
Prints the current version and release date. 


visual [msgiist] 
Edit the given messages with a screen editor. The mes- 
Sages are placed in a temporary file and the "VISUAL" vari- 
able is used to get the name of the editor (see ENVIRON- 
MENT VARIABLES). 


write [msgiist] filename 
Write the given messages on the specified file, minus the 
header and trailing blank line. Otherwise equivalent to the s 
ave command. 


xit 

exit 
Exit from mailx, without changing the mailbox. No mes- 
sages are saved in the mbox (see also q uit). 
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z[+t] 
Scroll the header display forward or backward one 
screen-—full. The number of headers displayed is set by the 
“screen” variable (see ENVIRONMENT VARIABLES). 


TILDE ESCAPES 
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The following commands may be entered only from input mode, by 
beginning a line with the tilde escape character (). See "escape" 
(ENVIRONMENT VARIABLES) for changing this special character. 


“! shell-command 
Escape to the shell. 


Simulate end of file (terminate message input). 


~: mail-command 

mail-command 
Perform the command-level request. Valid only when send- 
ing a message while reading mail. 


rs 
Print a summary of tilde escapes. 

“A 
Insert the autograph string “Sign” into the message (see 
ENVIRONMENT VARIABLES). 

“a 
Insert the autograph string "sign" into the message (see 
ENVIRONMENT VARIABLES). 

“b name ... 
Add the names to the blind carbon copy (Bcc) list. 

“C name ... 
Add the names to the carbon copy (Cc) list. 

“d 
Read in the dead./etter file. See "DEAD" (ENVIRONMENT 
VARIABLES) for a description of this file. 

“e 


Invoke the editor on the partial message. See also "EDI- 
TOR" (ENVIRONMENT VARIABLES). 
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“f [msglist] — 
Forward the specified messages. The messages are  — | 
inserted into the message, without alteration. 

“h 
Prompt for Subject line and To, Cc, and Bcc lists. If the 
field is displayed with an initial value, it may be edited as if 
you had just typed it. 

“1 string 
Insert the value of the named variable into the text of the 
message. For example, “A is equivalent to ‘i Sign.’ 

“m [msgliist] 

Insert the specified messages into the letter, shifting the 
new text to the right one tab stop. Valid only when sending 
a message while reading mail. 

‘p 
Print the message being entered. 

“q - 
Quit from input mode by simulating an interrupt. If the body <_' 
of the message is not null, the partial message is saved in 
dead.letter. See "DEAD" (ENVIRONMENT VARIABLES) for a 
description of this file. 

“r filename 

“< filename 

“< Ishell-command 
Read in the specified file. If the argument begins with an 
exclamation point (!), the rest of the string is taken as an 
arbitrary shell command and is executed, with the standard 
output inserted into the message. 

“S string ... 

Set the subject line to string. 
“tname ... 
Add the given names to the To list. 

-y ae 
Invoke a preferred screen editor on the partial message. 
See also "VISUAL" (ENVIRONMENT VARIABLES). ad 
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"w filename 
Write the partial message onto the given file, without the 
header. 

"xX 


Exit as with “q except the message is not saved in 
dead. letter. 


‘| shell-command 
Pipe the body of the message through the given shell- 
command. lf the shell-command returns a successful exit 
status, the output of the command replaces the message. 


ENVIRONMENT VARIABLES 
The following are environment variables taken from the execution 
environment and are not alterable within mailx. 


HOME = directory 
The user’s base of operations. 


MAILRC = filename 
The name of the start-up file. Default is $HOME: .mailrc. 


The following variables are internal mai/x variables. They may be 
imported from the execution environment or set via the se t com- 
mand at any time. The uns et command may be used to erase 
variables. 


ailnet 
- All network names whose last component (login name) 
match are treated as identical. This causes the msglist 
message specifications to behave similarly. Default ts 
noalinet . See also the alt ernates command and the 
“metoo” variable. 


append 
Upon termination, append messages to the end of the mbox 
file instead of prepending them. Default is noappend. 


askcc 
Prompt for the Cc list after message is entered. Default is 
noaskcc . 


asksub 


Prompt for subject if it is not specified on the command line 
with the —s option. Enabled by default. 
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autoprint 
Enable automatic printing of messages after d elete and u 
ndelete commands. Default is noautoprint . 


bang 
Enable the special-casing of exclamation points (!) in shell 
escape command lines as in vi (7). Default is nobang . 


cmd = shell-command 
Set the default command for the pi pe command. No 
default value. 


conv=conversion | 
Convert uucp addresses to the specified address style. The 
only valid conversion now is internet , which requires a mail 
delivery program conforming to the RFC822 standard for 
electronic mail addressing. Conversion is disabled by 
default. See also "sendmail" and the —U command line 
option. 


crt =number 
Pipe messages having more than number lines through the 
command specified by the value of the "PAGER" variable 
(pg(1) by default). Disabled by default. 


DEAD= filename 
The name of the file in which to save partial letters in case 
of untimely interrupt or delivery errors. Default is 
S$HOME/dead. letter. 


debug 
Enable verbose diagnostics for debugging. Messages are 
not delivered. Default is nodebug . 


dot | 
Take a period on a line by itself during input from a terminal 
as end-of-file. Default is nodot . 


EDITOR =shell-command 
The command to run when the e dit or 
used. Default is ed (7). 


e@ command is 


escape=c 
Substitute c for the ~ escape character. 
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directory 

The directory for saving standard mail files. User specified 
file names beginning with a plus (+) are expanded by 
preceding the filename with this directory name to obtain the 
real filename. If directory does not start with a slash (/), 
$HOME is prepended to it. In order to use the plus (+) 
construct on a mailx command line, "folder" must be an 
exported sh environment variable. There is no default for 
the “folder” variable. See also “outfolder" below. 


Enable printing of the header summary when entering mailx. 
Enabled by default. 


hold 
Preserve all messages that are read in the mailbox instead 
of putting them in the standard mbox save file. Default is 
nohold . 

ignore 
Ignore interrupts while entering messages. Handy for noisy 
dial-up lines. Default is noignore . 

ignoreeof 
Ignore end-of-file during message input. Input must be ter- 
minated by a period (.) on a line by itself or by the ~. com- 
mand. Default is noignoreeof . See also “dot” above. 

keep 
When the mailbox is empty, truncate it to zero length 
instead of removing it. Disabled by default. 

keepsave 


Keep messages that have been saved in other files in the 
mailbox instead of deleting them. Default is nokeepsave . 


MBOX = filename 


metoo 
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The name of the file to save messages which have been 
read. The x it command overrides this function, as does 
saving the message explicitly in another file. Default is 
SHOME/mbox. 


lf your login appears as a recipient, do not delete it from the 
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list. Default is nometoo. 


LISTER=shell-command 
The command (and options) to use when listing the con- 
tents of the "folder" directory. The default is fs (7). 


onehop 

When responding to a message that was originally sent to 
several recipients, the other recipient addresses are nor- 
mally forced to be relative to the originating author's 
machine for the response. This flag disables alteration of 
the recipients’ addresses, improving efficiency in a network 
where all machines can send directly to ail other machines 
(i.e., one hop away). 


outfolder 
Causes the files used to record outgoing messages to be 
located in the directory specified by the “folder” variable 
unless the pathname is absolute. Default is nooutfolder . 
See "folder" above and the S ave, C opy, fo Ilowup, and F 
ollowup commands. 


page 
Used with the pi pe command to insert a form feed after 
each message sent through the pipe. Default is nopage . 


PAGER =sSshell-command 
The command to use as a filter for paginating output. This 
can also be used to specify the options to be used. Default 


is pg (7). 


prompt=string 
Set the command mode prompt to string. Default is "? ". 


quiet 
Refrain from printing the opening message and version 
when entering mai/x. Default is noquiet . 


record = filename 
Record all outgoing mail in filename. Disabled by default. 
See also "outfolder” above. 

save 
Enable saving of messages in dead./etter on interrupt or 
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FILES 


delivery error. See "DEAD" for a description of this file. 
Enabled by default. 


screen = number 
Sets the number of lines in a screen—full of headers for the 
h eaders command. 


sendmail = shell-command 
Alternate command for delivering messages. Default is mail 


(1). 


sendwait 
Wait for background mailer to finish before returning. 
Default is nosendwait . 


SHELL =shell-command 
The name of a preferred command interpreter. Default is sh 


(1). 


showto 
When displaying the header summary and the message is 
from you, print the recipient's name instead of the author's 
name. 


sign=string 
The variable inserted into the text of a message when the “a 
(autograph) command is given. No default (see also ‘I 
(TILDE ESCAPES)). 


Sign = string 
The variable inserted into the text of a message when the 
“A command is given. No default (see also 7% (TILDE 
ESCAPES)). 


toplines =number 
The number of lines of header to print with the to p com- 
mand. Default ts 5. 


VISUAL = shell-command 
The name of a preferred screen editor. Default is wi (7). 


$HOME/.mailrc personal start-up file 
$HOME/mbox secondary storage file 
/usr/mail/* post office directory 
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/ust/lib/mailx/mailx.help* help message files 


/ust/lib/mailx/mailx.rc global start-up file 

/tmp/R[emaqsx]* temporary files 
SEE ALSO 

mail(1), pg(1), Is(1). 


BUGS 
Where shell-command is shown as valid, arguments are not always 
allowed. Experimentation is recommended. 


Internal variables imported from the execution environment cannot 
be uns et. 


The full internet addressing is not fully supported by mai/x. The new 
standards need some time to settle down. 


Attempts to send a message having a line consisting only of a °.” 
are treated as the end of the message by mail/(1) (the standard mail 
delivery program). 
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NAME 
make — maintain, update, and regenerate groups of programs 


SYNOPSIS 
make [-f makefile] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [-m] [-t] 
[-d] [-q] [names] 


DESCRIPTION 
The following is a brief description of all options and some special 
names: 


-—f makefile Description file name. Makefile is assumed to be the 
name of a description file. A file name of — denotes the 
standard input. The contents of makefile override the 
built-in rules if they are present. 


—p Print out the complete set of macro definitions and tar- 
get descriptions. 


—i Ignore error codes returned by invoked commands. 
This mode is entered if the fake target name .IGNORE 
appears in the description file. 


—k Abandon work on the current entry, but continue on 
other branches that do not depend on that entry. 


-S Silent mode. Do not print command lines before exe- 
cuting. This mode is also entered if the fake target 
name .SILENT appears in the description file. 


— Do not use the built-in rules. 

—n No execute mode. Print commands, but do not execute 
them. Even lines beginning with an @ are printed. 

-b Compatibility mode for old makefiles. 

-e Environment variables override assignments within 
makefiles. 

—m Print a memory map showing text, data, and stack. 


This option is a no-operation on systems without the 
getu system call. 


—t Touch the target files (causing them to be up-to-date) 
rather than issue the usual commands. 


—d Debug mode. Print out detailed information on files and 
times examined. 


-q Question. The make command returns a zero or non- 
zero status code depending on whether the target file is 
or is not up-to-date. , 
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.DEFAULT If a file must be made but there are no explicit com- 
mands or relevant built-in rules, the commands associ- : 
ated with the name .DEFAULT are used if it exists. Sw 


-PRECIOUS Dependents of this target will not be removed when quit 
or interrupt are hit. 


.SILENT Same effect as the —s option. 
IGNORE Same effect as the -i option. 


Make executes commands in makefile to update one or more target 
names . Name is typically a program. If no -f option is present, 
makefile, Makefile, s.makefile, and s.Makefile are tried in order. 
lf makefile is — , the standard input is taken. More than one - 
makefile argument pair may appear. 


Make updates a target only if its dependents are newer than the tar- 
get. All prerequisite files of a target are added recursively to the list 
of targets. Missing files are deemed to be out of date. 


Makefile contains a sequence of entries that specify dependencies. 
The first line of an entry is a blank-separated, non-null list of targets, 
then a: , then a (possibly null) list of prerequisite files or dependen- 
cies. Text following a ; and all following lines that begin with a tab 
are shell commands to be executed to update the target. The first ~~ 
line that does not begin with a tab or # begins a new dependency 
or macro definition. Shell commands may be continued across lines 
with the <backslash><new-line> sequence. Everything printed by 
make (except the initial tab) is passed directly to the shell as is. 


Thus, 
echo a\ 
b 

will produce 
ab 


exactly the same as the shell would. 
Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two files a.o and 
b.o , and that they in turn depend on their corresponding source 
files (a.c and b.c ) and a common file incl.h : 


pgm: a.o b.o 

cc a.o0 b.o —-O pgm 
a.o: incl.h a.c 

cc -C a.c — 
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b.o: incl.h b.c 
CC’=C D.C 


Command lines are executed one at a time, each by its own shell. 
The first one or two characters in a command can be the following: 
-- @, -@, or @-. If @ is present, printing of the command is 
suppressed. If - is present, make ignores an error. A line is printed 
when it is executed unless the —S option is present, or the entry 
SILENT: is in makefile , or unless the initial character sequence 
contains a @. The —-n option specifies printing without execution; 
however, if the command line has the string $(MAKE) in it, the line is 
always executed (see discussion of the MAKEFLAGS macro under 
Environment ). The -t (touch) option updates the modified date of a 
file without executing any commands. 


Commands returning non-zero status normally terminate make . lf 
the —i option is present, or the entry .IGNORE: appears in makefile , 
or the initial character sequence of the command contains -. the 
error is ignored. If the —k option is present, work is abandoned on 
the current entry, but continues on other branches that do not 
depend on that entry. 


The —b option allows old makefiles (those written for the old version 
of make) to run without errors. The difference between the old ver- 
sion of make and this version is that this version requires all depen- 
dency lines to have a (possibly null or implicit) command associated 
with them. The previous version of make assumed, if no command 
was specified explicitly, that the command was null. 


Interrupt and quit cause the target to be deleted unless the target is 
a dependent of the special name .PRECIOUS. 


Environment 
The environment is read by make. All variables are assumed to be 
macro definitions and processed as such. The environment vari- 
ables are processed before any makefile and after the internal rules; 
thus, macro assignments in a makefile override environment vari- 
ables. The -e option causes the environment to override the macro 
assignments in a makefile. 


The MAKEFLAGS environment variable is processed by make as 
containing any legal input option (except -f, —p, and —d) defined for 
the command line. Further, upon invocation, make “invents” the 
variable if it is not in the environment, puts the current options into 
it, and passes it on to invocations of commands. Thus, 
MAKEFLAGS always contains the current input options. This proves 
very useful for “super-makes”. In fact, as noted above, when the 
-—n option is used, the command $(MAKE) is executed anyway; 
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hence, one can perform a make —n recursively on a whole software 
system to see what would have been executed. This is because the 
—n is put in MAKEFLAGS and passed to further invocations of 
$(MAKE) . This is one way of debugging all of the makefiles for a 
software project without actually doing anything. 


Macros 

Entries of the form string? = string2 are macro definitions. String2 
is defined as all characters up to a comment character or an unes- 
caped new-line. Subsequent appearances of 
$(string1[:subst? =[subst are replaced by string2 . The parentheses 
are optional if a single character macro name is used and there is 
no substitute sequence. The optional :subst?1 =subst2 is a substi- 
tute sequence. lf it is specified, all non-overlapping occurrences of 
subst? in the named macro are replaced by subst2. Strings (for the 
purposes of this type of substitution) are delimited by blanks, tabs, 
new-line characters, and beginnings of lines. An example of the use 
of the substitute sequence is shown under Libraries . 


Internal Macros 
There are five internally maintained macros which are useful for writ- 
ing rules for building targets. 


$* The macro $* stands for the file name part of the current 
dependent with the suffix deleted. It is evaluated only for 
inference rules. 


$@ The $@ macro stands for the full target name of the current 
_ target. It is evaluated only for explicitly named dependencies. 


$< The $< macro is only evaluated for inference rules or the 
-DEFAULT rule. It is the module which is out-of-date with 
respect to the target (i.e., the “manufactured” dependent file 
name). Thus, in the .c.o rule, the $< macro would evaluate to 
the .c file. An example for making optimized .o files from .c 
files is: 

.C.O: 
cc -c —O $*.c 


Or: 


.C.0: 
cc —-c —O $< 


$? The $? macro is evaluated when explicit rules from the 
makefile are evaluated. It is the list of prerequisites that are 
out of date with respect to the target; essentially, those 
modules which must be rebuilt. 
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$% The $% macro is only evaluated when the target is an archive 
library member of the form lib(file.o). In this case, $@ evalu- 
ates to lib and $% evaluates to the library member, file.o. 


Four of the five macros can have alternative forms. When an upper 
case D or F is appended to any of the four macros, the meaning is 
changed to “directory part” for D and “file part” for F. Thus, $(@D) 
refers to the directory part of the string $@. If there is no directory 
part, ./ is generated. The only macro excluded from this alternative 
form is $?. The reasons for this are debatable. 


Suffixes 
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Certain names (for instance, those ending with .o) have inferable 
prerequisites such as .c, .s, etc. If no update commands for such a 
file appear in makefile , and if an inferable prerequisite exists, that 
prerequisite is compiled to make the target. In this case, make has 
inference rules which allow building files from other files by examin- 
ing the suffixes and determining an appropriate inference rule to 
use. The current default inference rules are: 


c.c .sh .sh .c.0 .C.0 .C.C .S.0 .S.O .Y.0 -y.O .|.0 .I.0 
VG aV One C28. 20 sd 3S aD 


The internal rules for make are contained in the source file rules.c 
for the make program. These rules can be locally modified. To 
print out the rules compiled into the make on any machine in a form 
Suitable for recompilation, the following command is used: 


make -fp — 2>,;dev.null <,dev:null 


The only peculiarity in this output is the (null). string which printf 
(3S) prints when handed a null string. 


A tilde in the above rules refers to an SCCS file (see sccsfile (4)). 
Thus, the rule .c’.o would transform an SCCS C source file into an 
object file (.o). Because the s. of the SCCS files is a prefix, it is 
incompatible with make's suffix point-of-view. Hence, the tilde is a 
way of changing any file reference into an SCCS file reference. 


A rule with only one suffix (i.e., .c:) is the definition of how to build x 
from x.c. In effect, the other suffix is null. This is useful for building 
targets from only one source file (e.g., shell procedures, simple C 
programs). 


Additional suffixes are given as the dependency list for .SUFFIXES. 
Order is significant; the first possible name for which both a file and 
a rule exist is inferred as a prerequisite. The default list is: 


.SUFFIXES: .o .c -y .| .S 


Here again, the above command for printing the internal rules will 
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display the list of suffixes implemented on the current machine. 
Multiple suffix lists accumulate; .SUFFIXES: with no dependencies 
clears the list of suffixes. ee, 


Inference Rules 
The first example can be done more briefly. 


pgm: a.o b.o 
cc a.o b.o -Oo pgm 
a.o b.o: incl.h 


This is because make has a Set of internal rules for building files. 
The user may add rules to this list by simply putting them in the 
makefile. 


Certain macros are used by the default inference rules to permit the 
inclusion of optional matter in any resulting commands. For exam- 
ple, CFLAGS , LFLAGS , and YFLAGS are used for compiler options 
to cc (1), lex (1), and yacc (1), respectively. Again, the previous 
method for examining the current rules is recommended. 


The inference of prerequisites can be controlled. The rule to create 
a file with suffix .o from a file with suffix .c is specified as an entry 
with .c.o: as the target and no dependents. Shell commands asso- 
ciated with the target define the rule for making a .o file from a .c 
file. Any target that has no slashes in it and starts with a dot is 
identified as a rule and not a true target. he 


Libraries | 

lf a target or dependency name contains parentheses, it is assumed 
to be an archive library, the string within parentheses referring to a 
member within the library. Thus lib(file.o) and $(LIB)(file.o) both 
refer to an archive library which contains file.o. (This assumes the 
LIB macro has been previously defined.) The expression 
$(LIB)(file1.o file2.0) is not legal. Rules pertaining to archive 
libraries have the form .XX.a where the XX is the suffix from which 
the archive member is to be made. An unfortunate byproduct of the 
current implementation requires the XX to be different from the suffix 
of the archive member. Thus, one cannot have lib(file.o) depend 
upon file.o explicitly. The most common use of the archive inter- 
face follows. Here, we assume the source files are all C type 
source: 


lib: lib(file1.o) lib(file2.o) lib(file3.o) 
(echo lib is now up-to-date 

.C.a: 
$(CC) -—c $(CFLAGS) $< BPS 
ar rv $@ $7.0 = 
rm -f $7.0 See 
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FILES 


In fact, the .c.a rule listed above is built into make and is unneces- 
sary in this example. A more interesting, but more limited example 
of an archive library maintenance construction follows: 


lib: lib(file1.o) lib(file2.0) lib(file3.o) 
$(CC) —c $(CFLAGS) $(?:.0=.c) 
ar rv lib $? 


rm $? «echo lib is now up-to-date 
C.a!} 

Here the substitution mode of the macro expansions is used. The 
$? list is defined to be the set of object file names (inside lib) 
whose C source files are out-of-date. The substitution mode 
translates the .o to .c. (Unfortunately, one cannot as yet transform 
to .c ; however, this may become possible in the future.) Note also, 
the disabling of the .c.a: rule, which would have created each object 
file, one by one. This particular construct speeds up archive library 
maintenance considerably. This type of construct becomes very 
cumbersome if the archive library contains a mix of assembly pro- 
grams and C programs. 


[Mmlakefile and s.[Mmlakefile 


SEE ALSO 


BUGS 
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cc(1), cd(1), lex(1), sh(1), yacc(1). 
printf(3S), sccsfile(4) in the Sys5 UNIX Programmer Reference 
Manual. 


Some commands return non-zero status inappropriately; use —i to 
overcome the difficulty. File names with the characters = : @ will 
not work. Commands that are directly executed by the shell, not- 
ably cd (7), are ineffectual across new-lines in make . The syntax 
(lib(file1.o file2.0 file3.o) is illegal. You cannot build lib(file.o) 
from file.o. The macro $(a:.0=.c’) does not work. 
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NAME 
makekey — generate encryption key ca 


SYNOPSIS ee 
/usr/lib/makekey 


DESCRIPTION 
Makekey improves the usefulness of encryption schemes depend- 
ing on a key by increasing the amount of time required to search the 
key space. It reads 10 bytes from its standard input, and writes 13 
bytes on its standard output. The output depends on the input in a 
way intended to be difficult to compute (i.e., to require a substantial 
fraction of a second). 


The first eight input bytes (the input key ) can be arbitrary ASCII 
characters. The last two (the sa/t ) are best chosen from the set of 
digits, . , / , and upper- and lower-case letters. The salt characters 
are repeated as the first two characters of the output. The remain- 
ing 11 output characters are chosen from the same set as the salt 
and constitute the output key . 


The transformation performed is essentially the following: the salt is 

used to select one of 4,096 cryptographic machines all based on the 
National Bureau of Standards DES algorithm, but broken in 4,096 
different ways. Using the input key as key, a constant string is fed ~~ 
into the machine and recirculated a number of times. The 64 bits — | 
that come out are distributed into the 66 output key bits in the 
result. 


Makekey is intended for programs that perform encryption (e.g., ed 
(1) and crypt (7)). Usually, its input and output will be pipes. 


SEE ALSO 


crypt(1), ed{1). 
passwd(4) in the Sys5 UNIX Programmer Reference Manual. 
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man — print entries in this manual 


SYNOPSIS 


man [ options | [ section ] titles 


DESCRIPTION 


FILES 


Man locates and prints the entry of this manual named title in the 
specified section . (For historical reasons, the word “page” is often 
used aS a synonym for “entry” in this context.) The title is entered 
in lower case. The section number may not have a letter suffix. If 
no section is specified, the whole manual is searched for title and 
all occurrences of it are printed. Options and their meanings are: 


-—Tterm Print the entry as appropriate for terminal type term . 
For a list of recognized values of term , type help 
term2 . The default value of term is 450. 

—wW Print on the standard output only the path names of the 
entries, relative to /usr/catman , or to the current direc- 
tory for —d option. 7 

—d Search the current directory rather than /usr/catman ; 


requires the full file name (e.g., cu.1e , rather than just 
cu ). 
—C Causes man to invoke co/ (1); note that co! (7) is 


invoked automatically by man unless term is one of 300 
, 300s , 450 , 37 , 4000a , 382 , 4014, tek , 1620 , and 
» 


Man examines the environment variable $TERM (see environ (5)) 
and attempts to select options that adapt the output to the terminal 
being used. The —Tterm option overrides the value of $TERM ; in 
particular, one should use -Tlp when sending the output of man to 
a line printer. | 


Section may be changed before each title . 
As an example: 
man man 


would reproduce on the terminal this entry, as well as any other 
entries named man that may exist in other sections of the manual. 


/usricatmani?_maniman[1-8]/* Preformatted manual entries 


SEE ALSO 
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term(5) in the Sys5 UNIX Programmer Reference Manual. 
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CAVEAT 
The man command prints manual entries that were formatted by 
nroff when the UNIX system was installed. Entries are originally for- 
matted with terminal type 37 , and are printed using the correct ter- 
minal filters as derived from the -—Tterm and $TERM settings. 
Typesetting or other non-standard printing of manual entries 
requires installation of the UNIX system Documenter’s Workbench. 
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NAME 

mesg — permit or deny messages 
SYNOPSIS 

mesg[n][y] 
DESCRIPTION 


Mesg with argument n forbids messages via write (7) by revoking 
non-user write permission on the user's terminal. Mesg with argu- 
ment y reinstates permission. All by itself, mesg reports the current 
state without changing it. 


FILES 
/dev/tty* 


SEE ALSO 
write(1). 


DIAGNOSTICS 
Exit status is 0 if messages are receivable, 1 if not, 2 on error. 


Page 1 May 23, 1985 


MKDIR(1) UNIX Sys5 MKDIR(1) 


NAME 

mkdir — make a directory 
SYNOPSIS 

mkdir dirname ... 
DESCRIPTION 


Mkdir creates specified directories in mode 777 (possibly altered by 
umask (1)). Standard entries, . , for the directory itself, and .. , for 
its parent, are made automatically. 


Mkdir requires write permission in the parent directory. 


SEE ALSO 
sh(1), rm(1), umask(1). 


DIAGNOSTICS 
Mkair returns exit code 0 if all directories were successfully made; 
otherwise, it prints a diagnostic and returns non-zero. 
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NAME 


mkstr — create an error message file by massaging C source 


SYNOPSIS 


/usr/plx/mkstr [ — ] messagefile prefix file ... 


DESCRIPTION 


Mkstr is used to create files of error messages. Its use can reduce 
the size of programs with large numbers of error diagnostics. It can 
also reduce system overhead in running the program, since the 
error messages do not have to be constantly swapped in and out. 


Mkstr will process each of the specified files, placing a massaged 
version of the input file in a file whose name consists of the speci- 
fied prefix and the original name. A typical usage of mkstr would be 


mkstr pistrings xx *.c 


This command would cause all the error messages from the C 
source files in the current directory to be placed in the file pistrings 
and processed copies of the source for these files to be placed in 
files whose names are prefixed with xx. 


- To process the error messages in the source to the message file 


Page 1 


mkstr keys on the string ‘error(’” in the input stream. Each time it 
occurs, the C string starting at the '” is placed in the message file 
followed by a null character and a new-line character; the null char- 
acter terminates the message so it can be easily used when 
retrieved, and the new-line character makes it possible to sensibly 
cat the error message file to see its contents. The massaged copy 
of the input file then contains a /seek pointer into the file. The 
pointer can then be used to retrieve the message, I.e.: 


char efilname[] = "usr lib. pi_strings”; 
int efil = -1; 


error(al, a2, a3, a4) 


{ 
char buf[256]: 


if (efil < 0) { 
efil = open(efilname, 0); 
if (efil < 0) { 
oops: 
perror(efilname); 
exit(1); 


Nene ome 
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MKSTR(1) 


if (Iseek(efil, (long) a1, 0) || read(efil, buf, 256) <= 0) 
goto oops; 
printf(buf, a2, a3, a4); 


i 


The optional — causes the error messages to be placed at the end 
of the specified message file for recompiling part of a large mkstr ed 


program. 


NOTES 
This program is based on a similar one from the University of Cali- 


fornia at Berkeley. 


SEE ALSO 
lseek(2), xstr(1) 


BUGS 
All the arguments except the name of the file to be processed are 


unnecessary. 
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mm, osdd, checkmm — print/check documents formatted with the 
MM macros 


SYNOPSIS 
mm [ options | [ files ] 


osdd [ options ] [ files |] 
checkmm |[ files | 


DESCRIPTION 
Mm can be used to type out documents using nroff and the MM 
text-formatting macro package. It has options to specify prepro- 
cessing by ftb/(1) and/or neqn (see eqn(1)) and postprocessing by 
various terminal-oriented output filters. The proper pipelines and the 
required arguments and flags for nroff and MM are generated, 
depending on the options selected. 


Osdd is equivalent to the command mm —mosd. For more informa- 
tion about the OSDD adapter macro package, see mosd(5). 


Options for mm are given below. Any other arguments or flags 
(e.g., -rC3) are passed to nroff or to MM, as appropriate. Such 
options can occur in any order, but they must appear before the 
files arguments. If no arguments are given, mm prints a list of its 
options. 


-Tterm Specifies the type of output terminal; for a list of recog- 
nized values for ferm, type help term2. If this option is 
not used, mm will use the value of the shell variable 
STERM from the environment (see profile(4) and 
environ(5)) as the value of ferm, if $TERM is set; other- 
wise, mm will use 450 as the value of term. If several 
terminal types are specified, the last one takes pre- 
cedence. 

-12 Indicates that the document is to be produced in 12-pitch. 
May be used when $TERM is set to one of 300, 300s, 
450, and 1620. (The pitch switch on the DAS! 300 and 
300s terminals must be manually set to 12 if this option is 
used. ) 

—C Causes mm to invoke co/(1); note that co/(1) is invoked 
automatically by mm unless term is one of 300, 300s, 
450, 37, 4000a, 382, 4014, tek, 1620, and X. 


—e Causes mm to invoke neqn; also causes neqn to read 
the /usr/pub/eqnchar file (see eqnchar{5)). 

—t Causes mm to invoke tb/(1). 

—E Invokes the —e option of nroff. 

—-y Causes mm to use the non-compacted version of the 


macros (see mm(5)). 
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HINTS 


As an example (assuming that the shell variable $TERM Is set in the 
environment to 450), the two command lines below are equivalent: 


mm —t —rC3 —12 ghh« 
tbl ghh* | nroff -cm —T450--12 —h -rC3 


Mm reads the standard input when — is specified instead of any file 
names. (Mentioning other files together with — leads to disaster.) 
This option allows mm to be used as a filter, e.g.: 


cat dws | mm — 


Checkmm is a program for checking the contents of the named files 
for errors in the use of the Memorandum Macros, missing or unbal- 
anced neqn delimiters, and .EQ/.EN pairs. Note: The user need not 
use the checkeq program (see eqn(1)). Appropriate messages are 
produced. The program skips all directories, and if no file name is 
given, standard input is read. 


1. Mm invokes nroff with the —-h flag. With this flag, nroff 
assumes that the terminal has tabs set every 8 character posi- 
tions. 

2. Use the -olist option of nroff to specify ranges of pages to be 
output. Note, however, that mm, if invoked with one or more of 


the —e, -t, and — options, together with the —olist option of nroff. 


may cause a harmless “broken pipe’ diagnostic if the last page 
of the document ts not specified in /ist 

3. If you use the -s option of nroff (to stop between pages of out- 
put), use line-feed (rather than return or new-line) to restart the 
output. The —s option of nroff does not work with the —c option 
of mm, or if mm automatically invokes co/(1) (see —e option 
above). 

4. If you lie to mm about the kind of terminal its output will be 
printed on, you will get (often subtle) garbage; however, if you 
are redirecting output into a file, use the —T37 option, and then 
use the appropriate terminal filter when you print that file. 


SEE ALSO 


col(1), env(1), eqn(1), greek(1), mmt(1), nroff(1), tbl(1), profile(4), 
mm(5), term(5). 

Sys5 UNIX Documenter’s Workbench Software Introduction and 
Reference Manual. | 


DIAGNOSTICS 
mm “mm: no input file” if none of the arguments is a readable 
file and mm is not used as a filter. 
checkmm 


“Cannot open filename” if file(s) is unreadable. The 
remaining output of the program is diagnostic of the 
source file. 
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NAME 


mmlint — sroff/MM nroff/MM document compatibility checker 


SYNOPSIS 


mmilint —s file 
mmulint —n file 


DESCRIPTION 


Mmlint reads file (an input document) and reports the document 
changes needed to convert the document to be runnable by the text 
formatter specified by the option. 


-s  mmiint will flag nroff/MM constructs that are illegal in sroff/MM. 
—n = mmiint will flag sroff/MM constructs that are illegal in nroff/MM. 


Constructs are commands, embedded commands, or register refer- 
ences. 


There are three types of messages: 


Equivalent messages, 
which give the equivalent construct in the target formatter. 


Non-equivalent messages, 
which indicate that there is no equivalent construct in the tar- 
get formatter. 


Warning messages, 
which describe the different meanings of a command or argu- 
ment in each formatter. 


Messages are output on standard output. 


CAVEATS 
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With the -s option, mmiint assumes the input file is in nroff/MM for- 
mat. However, if the file is in sroff/MM format, some erroneous 
messages may appear. For example, 

\(ad\(asr)): no special chars in sroff 


although this is a legal register construct in sroff. 


The same characteristic is true for the —n option, with the following 
messages: 


\(sl): use \n(sl) in nroff 
although in nroff, this is the character sequence "/)". 
\t: use \nt in nroff 


although in nroff, \t is the tab escape sequence. 
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\(:Mu): register names can only be two characters long 
in nroff 


although :M is a legal register name in nroff. 


.SO and .nx requests are ignored by mmlint. 
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NAME 


mmt, mvt — typeset documents, viewgraphs, and slides 


SYNOPSIS 


mmt [ options | [ files | 
mvt [ options | [ files ] 


DESCRIPTION 
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These two commands are very similar to mm(1), except that they 
both typeset their input via troff(1), as opposed to formatting it via 
nroff(1); mmt uses the MM macro package, while mvf uses the 
Macro Package for View Graphs and Slides. These two commands 
have options to specify preprocessing by tb/(1) and/or pic(1) and/or 
eqn(1). The proper pipelines and the required arguments and flags 
for troff(1) and for the macro packages are generated, depending on 
the options selected. 


Options are given below. Any other arguments or flags (e.g., -rC3) 
are passed to troff(1) or to the macro package, aS appropriate. 
Such options can occur in any order, but they must appear before 
the files arguments. If no arguments are given, these commands 
print a list of their options. 


—e Causes these commands to invoke eqn(1); also causes 
eqn to read the /usr/pub/eqnchar file (see eqnchar(5)). 

—t Causes these commands to invoke [b/(1). 

—p Invokes pic(1). 


—Taps Creates output for an Autologic APS-5 phototypesetter, 
and sends it to the default destination at this installation. 

—Tdest Creates output for troff device dest (see troff(1)). The 
output is sent through the appropriate postprocessor. 


—Tcat Uses otroff(1) to generate output for an on-line Wang 
CAT phototypesetter. 

—D4014 = Directs the output to a TEKTRONIX 4014 terminal via the 
tc(1) filter. 

—Dtek Same as —D4014. 

—Di10 Directs the output to the local Imagen Imprint-10 laser 
printer. 

—a Invokes the —a option of troff(1). 

-y Causes mmt to use the non-compacted version of the 
macros. This is the default except when using —Tcat. 

—z Invokes no output filter to process or redirect the output 
of troff(1). 


These commands read the standard input when — is_ specified 
instead of any file names. 


Mvt is just a link to mmt. 
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HINT 
Use the —olist option of troff(1) to specify ranges of pages to be out- 
put. Note, however, that these commands, if invoked with one or 
more of the -e, -t, and — options, together with the —o/list option of 
troff(1) may cause a harmless “broken pipe’ diagnostic if the last 
page of the document is not specified in /ist. 


SEE ALSO 
env(1), ean(1), mm(1), nroff(1), pic(1), tbl(1), tc(1), troff(1), pro- 
file(4), environ(5), mm(5), mv(5). 


DIAGNOSTICS 
“m[mv]t: no input file” if none of the arguments is a readable file 


and the command is not used as a filter. 
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more, page — file perusal filter for crt viewing 


SYNOPSIS 


/usr/p|x/more [ -d |] [ -f ] [ -1] [ -7 ] [ +/inenumber | [ +/pat- 
tern | [ name... ] 


page [| -d ] [ -f ] [ -l ] [ -7 ] [ +/4nenumber | [ +/pattern | [ 


Name ... 
DESCRIP TION 


More is a filter that allows examination of a continuous text one 
screenful at a time on a soft-copy terminal. It normally pauses after 
each screenful, printing --More-- at the bottom of the screen. If the 
user then types a carriage return, one more line ts displayed. If the 
user hits a space, another screenful is displayed. Other possibilites 
are enumerated later. 


The command line options are: 


=F] 


-d 


—f 


An integer that is the size (in lines) of the window that more 
will use instead of the default. 


More will prompt the user with the message "Hit space to 
continue, Rubout to abort" at the end of each screenful. 
This is useful if more is being used as a filter in some set- 
ting, such as a class, where many users may be unsophisti- 
cated. 


This causes more to count logical, rather than screen lines. 
That is, long lines are not folded. This option is recom- 
mended if nroff output is being piped through ul, since the 
latter may generate escape sequences. These escape 
sequences contain characters which would ordinarily occupy 
screen postions, but which do not print when they are sent 
to the terminal as part of an escape sequence. Thus more 
may think that lines are longer than they actually are, and 
fold lines erroneously. 


Do not treat “L (form feed) specially. If this option is not 
given, more will pause after any line that contains a ‘L, as if 
the end of a screenful had been reached. Also, if a file 
begins with a form feed, the screen will be cleared before 
the file is printed. 


+ linenumber 


Start up at linenumber. 


+/pattern 
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Start up two lines before the line containing the regular 
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expression pattern. 


If the program is invoked as page, then the screen is cleared before 
each screenful is printed (but only if a full screenful is being printed), 
and k -— 1 rather than k — 2 lines are printed in each screenful, 
where k is the number of lines the terminal can display. 


More looks in the file /etc’/termcap to determine terminal charac- 
teristics, and to determine the default window size. On a terminal 
capable of displaying 24 lines, the default window size is 22 lines. 


lf more is reading from a file, rather than a pipe, then a percentage 
is displayed along with the --More-- prompt. This gives the fraction 
of the file (in characters, not lines) that has been read so far. 


Other sequences which may be typed when more pauses, and their 
effects, are as follows (/ is an optional integer argument, defaulting 


to 1): 

i<space> 
display / more lines, (or another screenful if no argument is 
given) 

*D display 11 more lines (a “scroll’). If / is given, then the 
scroll size is set to /. 

d same as D (control-D) 

iz same as typing a space except that /, if present, becomes 
the new window size. 

is skip / lines and print a screenful of lines 

if skip i screenfuls and print a screenful of lines 


qorQ Exit from more. 
= Display the current line number. 
Vv Start up the editor vi at the current line. 


Help command; give a description of ail the more com- 
mands. 


i/expr search for the /-th occurrence of the regular expression 
expr. \f there are less than / occurrences of expr, and the 
input is a file (rather than a pipe), then the position in the file 
remains unchanged. Otherwise, a screenful is displayed, 
Starting two lines before the place where the expression 
was found. The users erase and kill characters may be 
used to edit the regular expression. Erasing back past the 
first column cancels the search command. 
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in search for the /-th occurrence of the last regular expression 
entered. 


(single quote) Go to the point from which the last search 
started. If no search has been performed in the current file, 
this command goes back to the beginning of the file. 


lcommand 
invoke a shell with command. The characters ‘%' and ‘l in 
“command” are replaced with the current file name and the 
previous shell command respectively. If there is no current 
file name, ‘% is not expanded. The sequences '\%" and "\!" 
are replaced by "%" and "!" respectively. 


in skip to the /-th next file given in the command line (skips to 
last file if n doesn't make sense) 


me) skip to the /-th previous file given in the command line. If 
this command is given in the middle of printing out a file, 
then more goes back to the beginning of the file. If doesn't 
make sense, more skips back to the first file. If more is not 
reading from a file, the bell is rung and nothing else hap- 
pens. 


f display the current file name and line number. 


‘q or :Q 
exit from more (same as q or Q). 


(dot) repeat the previous command. 


The commands take effect immediately, ie., it is not necessary to 
type a carriage return. Up to the time when the command character 
itself is given, the user may hit the line kill character to cancel the 
numerical argument being formed. In addition, the user may hit the 
erase character to redisplay the --More--(xx%) message. 


At any time when output is being sent to the terminal, the user can 
hit the quit key (normally control). More will stop sending output, 
and will display the usual --More-- prompt. The user may then enter 
one of the above commands in the normal manner. Unfortunately, 
some output is lost when this is done, due to the fact that any char- 
acters waiting in the terminal's output queue are flushed when the 
quit signal occurs. 


The terminal is set to noecho mode by this program so that the out- 
put can be continuous. What you type will thus not show on your 
terminal, except for the - and | commands. 


lf the standard output is not a teletype, then more acts just like cat, 
except that a header is printed before each file (if there is more than 
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one). 
A sample usage of more in previewing nroff output would be 
nroff —-ms +2 doc.n| more 


FILES 
‘etc/termcap Terminal data base 
/usrlib/more.help Help file 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
script(1) 
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NAME 


newform — change the format of a text file 


SYNOPSIS 


newform [-s] [-itabspec] [-otabspec] [-—bn] [-en] [-pn] [-an] 
[—f] [—-cchar] [-In] [files] 


DESCRIPTION 
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Newform reads lines from the named files , or the standard input if 
no input file is named, and reproduces the lines on the standard out- 
put. Lines are reformatted in accordance with command line 
options in effect. 


Except for —s , command line options may appear in any order, may 
be repeated, and may be intermingled with the optional files . Com- 
mand line options are processed in the order specified. This means 
that option sequences like “-e15 —I 60” will yield results different 
from “-—I60 -e 15’. Options are applied to all files on the command 
line. 


—itabspec Input tab specification: expands tabs to spaces, accord- 
ing to the tab specifications given. Tabspec recognizes 
all tab specification forms described in tabs (1). In addi- 
tion, tabspec may be — , in which newform assumes 
that the tab specification is to be found in the first line 
read from the standard input (see fspec (4)). If no 
tabspec is given, tabspec defaults to -8 . A tabspec of 
—0 expects no tabs; if any are found, they are treated as 
—1. 


—otabspec 
Output tab specification: replaces spaces by tabs, 
according to the tab specifications given. The tab specif- 
ications are the same as for -ifabspec. If no tabspec is 
given, tabspec defaults to -8 . A tabspec of -0 means 
that no spaces will be converted to tabs on output. 


-In Set the effective line length to n characters. If n is not 
entered, —I defaults to 72. The default line length without 
the -I option is 80 characters. Note that tabs and back- 
spaces are considered to be one character (use -i to 
expand tabs to spaces). 


—bn Truncate n characters from the beginning of the line 
when the line length is greater than the effective line 
length (see -In). Default is to truncate the number of 
characters necessary to obtain the effective line length. 
The default value is used when —b with no 7 is used. 
This option can be used to delete the sequence numbers 
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—S 
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from a COBOL program as follows: 
newform —l1 —b7 file-name 


The -l1 must be used to set the effective line length 
shorter than any existing line in the file so that the —b 
option is activated. 3 


Same as —bn except that characters are truncated from 
the end of the line. 


Change the prefix/append character to k . Default char- 
acter for kK is a space. 


Prefix n characters (see —ck) to the beginning of a line 
when the line length is less than the effective line length. 
Default is to prefix the number of characters necessary 
to obtain the effective line length. 


Same as -pn except characters are appended to the 
end of a line. 


Write the tab specification format line on the standard 
output before any other lines are output. The tab specifi- 
cation format line which is printed will correspond to the 
format specified in the /ast -o option. If no —o option is 
specified, the line which is printed will contain the default 
specification of -8 . 


Shears off leading characters on each line up to the first 
tab and places up to 8 of the sheared characters at the 
end of the line. If more than 8 characters (not counting 
the first tab) are sheared, the eighth character is 
replaced by a * and any characters to the right of it are 
discarded. The first tab is always discarded. 


An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The characters 
are then added at the end of the processed line. 


For example, to convert a file with leading digits, one or 
more tabs, and text on each line, to a file beginning with 
the text, all tabs after the first expanded to spaces, pad- 
ded with spaces out to column 72 (or truncated to 
column 72), and the leading digits placed starting at 
column 73, the command would be: 

newform —s —i —| —a -e file-name 
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DIAGNOSTICS 

All diagnostics are fatal. 

usage: ... Newform was Called with a bad option. 

not —s format There was no tab on one line. 

can’t open file Self-explanatory. 

internal line too long A line exceeds 512 characters after 
being expanded in the internal work 
buffer. 

fabspec in error A tab specification is incorrectly format- 
ted, or specified tab stops are not 
ascending. 


tabspec indirection illegal A tabspec read from a file (or standard 
Input) may not contain a_ tabspec 
referencing another file (or standard 
input). 
EXIT CODES 


0 — normal execution 
1 — for any error 


SEE ALSO 
csplit(1), tabs(1). 
fspec(4) in the Sys5 UNIX Programmer Reference Manual. 

BUGS 
Newform normally only keeps track of physical characters; however, 
for the -i and —o options, newform will keep track of backspaces in 
order to line up tabs in the appropriate logical columns. 


Newform will not prompt the user if a tabspec is to be read from the 
standard input (by use of —i— or -o— ). 


lf the -f option is used, and the last —o option specified was -o— , 
and was preceded by either a -o— or a —i— , the tab specification 
format line will be incorrect. 
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NAME 


newgrp — log in to a new group 


SYNOPSIS 


newgrp [-] [ group ] 


DESCRIPTION 


Newgrp changes a user’s group identification. The user remains 
logged in and the current directory is unchanged, but calculations of 
access permissions to files are performed with respect to the new 
real and effective group IDs. The user is always given a new shell, 
replacing the current shell, by newgrp , regardless of whether it ter- 
minated successfully or due to an error condition (i.e., unknown 


group). 


Exported variables retain their values after invoking newgrp ; how- 
ever, all unexported variables are either reset to their default value 
or set to null. System variables (such as PS1, PS2, PATH, MAIL, 
and HOME), unless exported by the system or explicitly exported by 
the user, are reset to default values. For example, a user has a pri- 
mary prompt string (PS1) other than $ (default) and has not 
exported PS1. After an invocation of newgrp , successful or not, 
their PS1 will now be set to the default prompt string $. Note that 
the shell command export (see sh(1)) is the method to export vari- 
ables so that they retain their assigned value when invoking new 
shells. 


With no arguments, newgrp changes the group identification back 
to the group specified in the user's password file entry. 


If the first argument to newgrp is a — , the environment is changed 
to what would be expected if the user actually logged in again. 


A password is demanded if the group has a password and the user 
does not, or if the group has a password and the user is not listed in 
/etc’group as being a member of that group. | 


FILES 
/etc/group system's group file 
/etc/passwd system's password file 
SEE ALSO 
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login(1), sh(1). 
group(4), passwd(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 
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BUGS 
-_ There is no convenient way to enter a password into /etc/group . 
( Use of group passwords is not encouraged, because, by their very 
nature, they encourage poor security practices. Group passwords 
may disappear in the future. 
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NAME 


news — print news items 


SYNOPSIS 


news [ -a ][-n]|[-s ][ items ] 


DESCRIPTION 


FILES 


News is used to keep the user informed of current events. By con- 
vention, these events are described by files in the directory 
/usr/news . 


When invoked without arguments, news prints the contents of all 
current files in /usr/news , most recent first, with each preceded by 
an appropriate header. News stores the “currency” time as the 
modification date of a file named .news_time in the user's home 
directory (the identity of this directory is determined by the environ- 
ment variable $HOME ); only files more recent than this currency 
time are considered “current.” 


The -a option causes news to print all items, regardless of 
currency. In this case, the stored time is not changed. 


The —n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 


The -s option causes news to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. It is useful to include such an invocation of news in 
one's .profile file, or in the system's /etc/profile . 


All other arguments are assumed to be specific news items that are 
to be printed. 


lf a delete is typed during the printing of a news item, printing stops 
and the next item is started. Another de/fete within one second of 
the first causes the program to terminate. 


/etc/profile 
/UST/NeWS/* 
$HOME/.news_time 


SEE ALSO 
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profile(4), environ(5) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 
nice — run a command at low priority 


SYNOPSIS 
nice [ — increment | command [ arguments | 


DESCRIPTION 
Nice executes command with a lower CPU scheduling priority. If 
the increment argument (in the range 1-19) is given, it is used; if 
not, an increment of 10 is assumed. 


The super-user may run commands with priority higher than normal 
by using a negative increment, e.g., —10. 


SEE ALSO 

nohup(1). 

nice(2) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS 

Nice returns the exit status of the subject command. 


BUGS 
An increment larger than 19 is equivalent to 19. 


Page 1 May 23, 1985 


NL(1) UNIX Sys5 NL(1) 


NAME 
nl — line numbering filter 


SYNOPSIS 
ni [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-—Inum] 
[-ssep] [-wwidth] [—nformat] [-—ddelim] file 


DESCRIPTION 
Ni reads lines from the named file or the standard input if no file is 
named and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 
effect. 


Ni views the text it reads in terms of logical pages. Line numbering 
is reset at the start of each logical page. A logical page consists of 
a header, a body, and a footer section. Empty sections are valid. 
Different line numbering options are independently available for 
header, body, and footer (e.g., no numbering of header and footer 
lines while numbering blank lines only in the body). 


The start of logical page sections are signaled by input lines contain- 
ing nothing but the following delimiter character(s): 


Line contents — Start of 


wy: header 
ea body 
‘ footer 


Unless optioned otherwise, n/ assumes the text being read is in a 
single logical page body. 


Command options may appear in any order and may be intermin- 
gled with an optional file name. Only one file may be named. The 
options are: 


—btype Specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a , 
number all lines; t , number lines with printable text only; 
n , no line numbering; pstring, number only lines that 
contain the regular expression specified in string . 
Default type for logical page body is t (text lines num- 
bered). 


-hiype Same as —btype except for header. Default type for 
| logical page header is n (no lines numbered). 


—fiype Same as —btype except for footer. Default for logical 
page footer is n (no lines numbered). 
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op 
—vstart# 


—jincr 


—SSED 


—wwiath 


—nformat 


—Inum 


—dxx 


EXAMPLE 
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Do not restart numbering at logical page delimiters. 


Start# is the initial value used to number logical page 
lines. Default is 1. 


Incr is the increment value used to number logical page 
lines. Default is 1. 


Sep is the character(s) used in separating the line 
number and the corresponding text line. Default sep is a 
tab. 


Width is the number of characters to be used for the line 
number. Default width is 6. 


Format is the line numbering format. Recognized values 
are: In , left justified, leading zeroes suppressed; rn , 
right justified, leading zeroes supressed; rz , right justi- 
fied, leading zeroes kept. Default format is rn (right justi- 
fied). 


Num is the number of blank lines to be considered as 
one. For example, -I2 results in only the second adja- 
cent blank being numbered (if the appropriate —ha , —ba 
, andor —fa option is set). Default is 1. 


The delimiter characters specifying the start of a logical 
page section may be changed from the default charac- 
ters (\:) to two user-specified characters. If only one 
character is entered, the second character remains the 
default character (:). No space should appear between 
the -d and the delimiter characters. To enter a 
backslash, use two backslashes. 


The command: 


ni —v10 -110 —-d!-+ file 


will number file1 starting at line number 10 with an increment of ten. 
The logical page delimiters are !+. 


SEE ALSO 
pr(1). 
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nm — print name list of common object file 


SYNOPSIS 


nm [—o] [—x] [—h] [-v] [-n] [-e] [-f] [-u] [-V] [-T] file-names 


DESCRIPTION 


The nm command displays the symbol table of each common object 
file file-name . File-name may be a relocatable or absolute common 
object file; or it may be an archive of relocatable or absolute com- 
mon object files. For each symbol, the following information will be 


printed: 
Name 
Value 


Class 
Type 


Size 


Line 


Section 


The name of the symbol. 


Its value expressed as an offset or an address depending 
on its storage class. 


Its storage class. 


Its type and derived type. If the symbol is an instance of 
a structure or of a union then the structure or union tag 
will be given following the type (e.g., struct-tag). If the 
symbol is an array, then the array dimensions will be 
given following the type (eg., char[ n ][ m ] ). Note that 
the object file must have been compiled with the —g option 
of the cc (7) command for this information to appear. 


Its size in bytes, if available. Note that the object file 
must have been compiled with the -—g option of the cc (7) 
command for this information to appear. 


The source line number at which it is defined, if available. 
Note that the object file must have been compiled with the 
—g option of the cc (7) command for this information to 
appear. 


For storage classes static and external, the object file sec- 
tion containing the symbol (e.g., text, data or bss). 


The output of nm may be controlled using the following options: 


—O 
aa’ 


—-h 


—V 
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Print the value and size of a symbol in octal instead of 
decimal. 


Print the value and size of a symbol in hexadecimal 
instead of decimal. | 


Do not display the output header data. 
Sort external symbols by value before they are printed. 
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Sort external symbols by name before they are printed. 
Print only external and static symbols. 


Produce full output. Print redundant symbols (.text, .data 
and .bss), normally suppressed. 


Print undefined symbols only. 


Print the version of the nm command executing on the 
standard error output. 


By default, mm prints the entire name of the symbols 
listed. Since object files can have symbols names with an 
arbitrary number of characters, a name that Is longer than 
the width of the column set aside for names will overflow 
its column, forcing every column after the name to be 
misaligned. The -—T option causes nm to truncate every 
name which would otherwise overflow its column and 
place an asterisk as the last character in the displayed 
name to mark it as truncated. 


Options may be used in any order, either singly or in combination, 
and may appear anywhere in the command line. Therefore, both 
nm name -e -v and nm —ve name print the static and external 
symbols in name , with external symbols sorted by value. 


FILES 


CAVEATS 


When all the symbols are printed, they must be printed in the order 
they appear in the symbol table in order to preserve scoping infor- 
mation. Therefore, the -v and —n options should be used only in 
conjunction with the —e option. 


SEE ALSO 


as(1), cc(1), Id(1). 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 


~ DIAGNOSTICS 


“nm: name: cannot open” 


if name cannot be read. 


“nm: name: bad magic” 


if name is not an appropriate common object file. 


“nm: name: no symbols” 
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NAME 
nohup — run a command immune to hangups and quits aa * 
SYNOPSIS Se 
nohup command [ arguments | 
DESCRIPTION 


Nohup executes command with hangups and quits ignored. If out- 
put is not re-directed by the user, both standard output and standard 
error are sent to nohup.out . If nohup.out is not writable in the 
current directory, output is redirected to $HOME/nohup.out . 


EXAMPLE 
It is frequently desirable to apply nohup to pipelines or lists of com- 
mands. This can be done only by placing pipelines and command 
lists in a single file, called a shell procedure. One can then issue: 


nohup sh file 


and the nohup applies to everything in file. If the shell procedure file 
is to be executed often, then the need to type sh can be eliminated 
by giving file execute permission. Add an ampersand and the con- 
tents of file are run in the background with interrupts also ignored 
(see sh (7)): 


nohup file & Me 
An example of what the contents of fife could be is: 


tbl ofile | eqn | nroff > nfile 


SEE ALSO 
chmod(1), nice(1), sh(1). 
signal(2) in the Sys5 UNIX Programmer Reference Manual. 


WARNINGS 
nohup command; command2 nohup applies only to command? 
nohup (command1; command2) is syntactically incorrect. 


Be careful of where standard error is redirected. The following com- 
mand may put error messages on tape, making it unreadable: 


nohup cpio —o <list >/dev/rmt 1m& 
while 
nohup cpio —o <list >/dev/rmt'1m 2>errors& 


puts the error messages into file errors . 
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nroff, otroff — format or typeset text 


SYNOPSIS 
nroff [ options |] [ files ] 


otroff [ options ] [ files ] 


DESCRIPTION 
Nroff formats text contained in files (standard input by default) for 
printing on typewriter-like devices and line printers; similarly, otroff 
formats text for a Wang Laboratories, Inc., C/A/T phototypesetter. 
Their capabilities are described in the NROFF/TROFF User Manual 
cited below. 


An argument consisting of a minus (—) is taken to be a file name 
corresponding to the standard input. The options, which may 
appear in any order, but must appear before the files, are: 


—Olist 


—nN 
—SN 


—raN 


Print only pages whose page numbers appear in the /ist 
of numbers and ranges, separated by commas. A range 
N-M means pages N through M; an initial -N means 
from the beginning to page N; and a final N— means from 
N to the end. (See BUGS below.) 

Number first generated page N. 

Stop every N pages. Nroff will halt after every N pages 
(default N=1) to allow paper loading or changing, and will 
resume upon receipt of a line-feed or new-line (new-lines 
do not work in pipelines, e.g., with mm(1)). This option 
does not work if the output of nroff is piped through 
col(1). Otroff will stop the phototypesetter every N 
pages, produce a trailer to allow changing cassettes, and 
resume when the typesetter’s start button is pressed. 
When nroff (otroff) halts between pages, an ASCII BEL (in 
otroff, the message page stop) is sent to the terminal. 
Set register a (which must have a one-character name) to 
N. 

Read standard input after files are exhausted. 

Invoke the simultaneous input-output mode of the .rd 
request. 

Print only messages generated by .tm (terminal mes- 
sage) requests. 

Prepend to the input files the non-compacted (ASCII text) 
macro file /usr/ib/tmac/tmac.name. 

Prepend to the input files the compacted macro files 


-fusr/lib/macros/cmp.[ nt ].[ dt ].name and 


/usr/lib/macros/ucmp.[ nt ].name. 
Compact the macros used in this invocation. of 
nroff/otroff, placing the output in files [dt].name in the 
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Nroff only: 


Otroff only: 


FILES 
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current directory (see the NROFF/TROFF User Manual for 
details of compacting macro files). 


—Tname 


—t 


—f 


—Tcat 


Prepare output for specified terminal. Known names are 37 
for the (default) TELETYPE® Model 37 terminal, tn300 for 
the GE TermiNet 300 (or any terminal without half-line capa- 
bility), 300s for the DAS! 300s, 300 for the DAS! 300, 450 for 
the DASI 450, Ip for a (generic) ASCII line crinter, 382 for the 
DTC-382, 4000A for the Trendata 4000A, 832 for the Ander- 
son Jacobson 832, X for a (generic) EBCDIC printer, and 
2631 for the Hewlett Packard 2631 line printer. 


Produce equally-spaced words in adjusted lines, using the 
full resolution of the particular terminal. 


Use output tabs during horizontal spacing to speed output 
and reduce output character count. Tab settings are 
assumed to be every 8 nominal character widths. 


Set the emboldening factor (number of character over- 
strikes) for the third font position (bold) to n, or to zero if n 
is missing. 


Direct output to the standard output instead of the photo- 
typesetter. 


Refrain from feeding out paper and stopping phototypesetter 
at the end of the run. 


Wait until phototypesetter is available, if it is currently busy. 


Report whether the phototypesetter is eeuey or available. No 
text processing is done. 


Send a printable ASCII approximation of the results to the 
standard output. 


Print all characters in point size N while retaining all 
prescribed spacings and motions, to reduce phototypesetter 
elapsed time. 


Use font-width tables for Wang CAT phototypesetter. This 
device is both the default and the only choice. 


/usr/lib/suftab suffix hyphenation tables 


ftmp/ta$# temporary file 
/usr/lib/tmac/tmac.* standard macro files and pointers 
/usr/lib/macros/* standard macro files 


fusr/lib/term/* terminal driving tables for nroff 
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/usr/lib/font/* font width tables for otroff 


SEE ALSO 
( | eqn(1), ocw(1), tol(1), mm(5). 


nroff only- 
col(1), greek(1), mm(1). 


otroff only- 
mmt(1), mv(5). 


BUGS | 
Nroff/otroff believes in Eastern Standard Time; as a result, depend- 
ing on the time of the year and on your local time zone, the date 
that nroff/otroff generates may be off by one day from your idea of 
what the date is. 


When nroff/otroff is used with the —o/ist option inside a pipeline 
(e.g., with one or more of ocw(1), egn(1), and fb/(1)), it may cause 
a harmless “broken pipe” diagnostic if the last page of the docu- 
ment is not specified in /ist. 
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NAME 
ocw, checkcw — prepare constant-width text for otroff 

SYNOPSIS ( 
ocw [ -Iixx ] [ -rxx ] [ -fn ] [ +t ] [ +t] [ -d ] [ files ] Ha oe 
checkcw [ -Ixx ] [ -rxx ] files 

DESCRIPTION 


Ocw is a preprocessor for otroff (see nroff(1)) input files that con- 
tain text to be typeset in the constant-width (CW) font on the Wang 
CAT phototypesetter. This preprocessor is not necessary for users 
of the new device-independent troff(1), nor is it compatible with it. 
Refer to the Addendum to the NROFF/TROFF User Manual for 
details on how to eliminate the use of this command. 


Text typeset with the CW font resembles the output of terminals and 
of line printers. This font is used to typeset examples of programs 
and of computer output in user manuals, programming texts, etc. 
(An earlier version of this font was used in typesetting The C Pro- 
gramming Language by B. W. Kernighan and D. M. Ritchie.) It has 
been designed to be quite distinctive (but not overly obtrusive) when 
used together with the Times Roman font. 


Because the CW font on the Wang CAT contains a “non-standard” 
set of characters and because text typeset with it requires different 
character and inter-word spacing than is used for “standard” fonts, 
documents that use the CW font must be preprocessed by ocw. Se 


The CW font contains the 94 printing ASCII characters: 


abcdefghijklmnoparstuvwxyz 
ABCDEFGHIJKLMNOPQRS TUVWXYZ 
0123456789 

se ald Vere Gira el aan 


plus eight non-ASCll characters represented by four-character otroff 
names (in some cases attaching these names to “non-standard” 


graphics): 

Character Symbol  Troff Name 

“Cents” sign ¢ \(ct 

EBCDIC “not” sign - \(nNo 

Left arrow ~ \(<- 

Right arrow * \(-> 

Down arrow \ \(da 

Vertical single quote \(fm 

Control-shift indicator > \(dg 

Visible space indicator z \(sq Z 
Hyphen - \(hy ‘ 
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The hyphen is a synonym for the unadorned minus sign ( - ). Cer- 
tain versions of ocw recognize two additional names: \ (ua for an 
up arrow and \ (Ih for a diagonal left-up (home) arrow. 


Ocw recognizes five request lines, as well as user-defined delim- 
iters. The request lines look like otroff macro requests, and are 
copied in their entirety by ocw onto its output; thus, they can be 
defined by the user as otroff macros; in fact, the .CW and .CN mac- 
ros should be so defined (see HINTS below). The five requests are: 


.CW Start of text to be set in the CW font; .CW causes a break; it 
can take precisely the same options, in precisely the same 
format, as are available on the ocw command line. 


.CN End of text to be set in the CW font; .CN causes a break; it 
can take the same options as are available on the ocw 
command line. 


.CD Change delimiters and/or settings of other options; takes the 
same options as are available on the ocw command line. 


.CP arg? arg2 arg3 ... argn 
All the arguments (which are delimited like otroff macro 
arguments) are concatenated, with the odd-numbered argu- 
ments set in the CW font and the even-numbered ones in 
the prevailing font. 


-PC arg? arg2 arg3 ... argn 
Same as .CP, except that the even-numbered arguments 
are set in the CW font and the odd-numbered ones in the 
prevailing font. 


The .CW and .CN requests are meant to bracket text (e.g., a pro- 
gram fragment) that is to be typeset in the CW font “as is.’ Nor- 
mally, ocw operates in the transparent mode. In that mode, except 
for the .CD request and the nine special four-character names listed 
in the table above, every character between .CW and .CN request 
lines stands for itself. In particular, ocw arranges for periods ( .) 
and apostrophes (’ ) at the beginning of lines, and backslashes ( \ ) 
everywhere to be “hidden” from otroff. The transparent mode can 
be turned off (see below), in which case normal otroff rules apply; in 
particular, lines that begin with . and ’ are passed through 
untouched (except if they contain delimiters—see below). In either 
case, ocw hides the effect of the font changes generated by the 
.CW and .CN requests; ocw also defeats all ligatures (fi, ff, etc.) in 
the CW font. 


The only purpose of the .CD request is to allow the changing of vari- 
ous options other than just at the beginning of a document. 


The user can also define delimiters. The left and right delimiters 
perform the same function as the .CW/.CN requests; they are 
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HINTS 
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meant, however, to enclose CW ‘words’ or “phrases” in running text 
(see example under BUGS below). Ocw treats text between delim- 
iters in the same manner as text enclosed by .CW/.CN pairs, 
except that, for aesthetic reasons, spaces and backspaces inside 
-CW/.CN pairs have the same width as other CW characters. 
While spaces and backspaces between delimiters are half as wide, 
so they have the same width as spaces in the prevailing text (but 
are not adjustable). Font changes due to delimiters are not hidden. 


Delimiters have no special meaning inside .CW/.CN pairs. 
The options are: 


-1xx The one- or two-character string xx becomes the left delim- 
iter; if xx is omitted, the left delimiter becomes undefined, 
which it is initially. 

-rxx Same for the right delimiter. The left and right delimiters 
may (but need not) be different. 


-fn The CW font is mounted in font position n; values for n are 
1, 2, and 3 (default is 3, replacing the bold font). This 
option is only useful at the beginning of a document. 


-t Turn transparent mode off. 
+t Turn transparent mode on (this is the initial default). 
-d Print current option settings on file descriptor 2 in the form 


of otroff comment lines. This option is meant for debugging. 


Ocw reads the standard input when no files are specified (or when - 
is specified as the last argument), so it can be used as a filter. Typ- 
ical usage is: ocw files | otroff .... Checkcw checks that left and right 
delimiters, as well as the .CW/.CN pairs, are properly balanced. It 
prints out all offending lines. 


Typical definitions of the .CW and .CN macros meant to be used with 
the mm(5) macro package: 


de CW 

.DS | 

.ps 9 

.vS 10.5p 

ta 16m/3u 32m/3u 48m/3u 64m/3u 80m/SuU 96m/3u ... 
.de CN 

ta 0.5) 11 1.51 21 2.51 31 3.51 41 4.5151 5.51 61 

VS 


.ps 
.DE 
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FILES 


At the very least, the .CW macro should invoke the otroff no-fill (.nf) 
mode. 


When set in running text, the CW font is meant to be set in the same 
point size as the rest of the text. In displayed matter, on the other 
hand, it can often be profitably set one point mailer than the prevail- 
ing point size (the displayed definitions of .CW and .CN above are 
one point smaller than the running text on this page). The CW font 
is sized so that, when it is set in 9-point, there are 12 characters per 
inch. 


Documents that contain CW text may also contain tables and/or 
equations. If this is the case, the order of preprocessing should be: 
ocw, tbi, and eqn. Usually, the tables contained in such documents 
will not contain any CW text, although it is entirely possible to have 
elements of the table set in the CW font; of course, care must be 
taken that tbi/(1) format information not be modified by ocw. 
Attempts to set equations in the CW font are not likely to be either 
pleasing or successful. 


In the CW font, overstriking is most easily accomplished with back- 
spaces: letting <- represent a backspace, d--\(dg yields d. 
(Because backspaces are half as wide between delimiters as inside 
.CW/.CN pairs—see above—two backspaces are required for each 
overstrike between delimiters. ) 


/usr/ib/font/ftCWw CW font-width table 


SEE ALSO 


eqn(1), nroff(1), tol(1), mm(5), mv(5). 


WARNINGS 


BUGS 


If text preprocessed by ocw is to make any sense, it must be set on 
a typesetter equipped with the CW font or on a STARE facility; on the 
latter, the CW font appears as bold, but with the proper CW spacing. 


Only a masochist would use periods (.), backslashes (\), or double 
quotes (") as delimiters, or as arguments to .CP and .PC. 

Certain CW characters do not concatenate gracefully with certain 
Times Roman characters, e.g., a CW ampersand (&) followed by a 
Times Roman comma(,). In such cases, judicious use of otroff half- 
and quarter-spaces (\| and \‘) is most salutary, e.g., one should use 
_&_\, (rather than just plain _&_,) to obtain &, (assuming that _ Is 
used for both delimiters). 

Using ocw with nroff is silly. 

The output of ocw is hard to read. 

See also BUGS under nroff(1). 
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NAME 
( | od — octal dump 


SYNOPSIS 
od [ —bcdox | [ file | [| + Joffsetl. ][ b ] ] 


DESCRIPTION 
Od dumps file in one or more formats as selected by the first argu- 
ment. If the first argument is missing, —o is default. The meanings 
of the format options are: 


—b Interpret bytes in octal. 


—C Interpret bytes in ASCII. Certain non-graphic characters 
appear as C escapes: null=\0, backspace=\b, form-feed=\f, 
new-line=\n, return=\r, tab=\t; others appear as 3-digit octal 
numbers. 


—d Interpret words in decimal. 
—O Interpret words in octal. 
—X Interpret words in hex. 


The file argument specifies which file is to be dumped. If no file 
argument is specified, the standard input is used. 


em The offset argument specifies the offset in the file where dumping is 
( | to commence. This argument is normally interpreted as octal bytes. 
7 If . is appended, the offset is interpreted in decimal. If b is 
appended, the offset is interpreted in blocks of 512 bytes. If the file 

argument is omitted, the offset argument must be preceded by + . 


Dumping continues until end-of-file. 


NOTES 
Plexus provides a standalone version of od in addition to the one 
that runs under Sys5. 


SEE ALSO 
adb(1). 
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NAME 


pack, pcat, unpack — compress and expand files 


SYNOPSIS 


pack [ - |] [-f ] name... 
peat name ... 
unpack name ... 


DESCRIPTION 


Page 1 


Pack attempts to store the specified files in a compressed form. 
Wherever possible (and useful), each input file name is replaced by 
a packed file name.z with the same access modes, access and 
modified dates, and owner as those of name . The -f option will 
force packing of name . This is useful for causing an entire directory 
to be packed even if some of the files will not benefit. If pack is 
successful, name will be removed. Packed files can be restored to 
their original form using unpack or pcat . 


Pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the —- argument is used, an internal flag is set that causes 
the number of times each byte is used, its relative frequency, and 
the code for the byte to be printed on the standard output. Addi- 
tional occurrences of — in place of name will cause the internal flag 
to be set and reset. 


The amount of compression obtained depends on the size of the 
input file and the character frequency distribution. Because a 
decoding tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the char- 
acter frequency distribution is very skewed, which may occur with 
printer plots or pictures. | 


Typically, text files are reduced to 60-75% of their original size. 
Load modules, which use a larger character set and have a more 
uniform distribution of characters, show little compression, the 
packed versions being about 90% of the original size. 


Pack returns a value that is the number of files that it failed to 
compress. 


No packing will occur if: 


the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 
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a file called name.z already exists; 
the .z file cannot be created: 
an |/O error occurred during processing. 


The last segment of the file name must contain no more than 12 
characters to allow space for the appended .z extension. Direc- 
tories Cannot be compressed. 


Pcat does for packed files what cat (7) does for ordinary files, 
except that pcat can not be used as a filter. The specified files are 
unpacked and written to the standard output. Thus to view a 
packed file named name.z use: 


pcat name.z 
or just: 

pcat name 
To make an unpacked copy, say nnn , of a packed file named 
name.z (without destroying name.z) use the command: 


pcat name >nnn 


Pcat returns the number of files it was unable to unpack. Failure 
may occur if: 


the file name (exclusive of the .z ) has more than 12 char- 
acters; 

the file cannot be opened; 

the file does not appear to be the output of pack . 


Unpack expands files created by pack . For each file name speci- 
fied in the command, a search is made for a file called name.z (or 
just name , if name ends in .z ). If this file appears to be a packed 
file, it is replaced by its expanded version. The new file has the .z 
suffix stripped from its name, and has the same access modes, 
access and modification dates, and owner as those of the packed 
file. 


Unpack returns a value that is the number of files it was unable to 
unpack. Failure may occur for the same reasons that it may in pcat 
, as well as for the following: 


a file with the “unpacked” name already exists; 
if the unpacked file cannot be created. 


SEE ALSO 
cat(1). 
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NAME 


passwd — change login password 


SYNOPSIS 


passwd [ name | 


DESCRIPTION 
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This command changes or installs a password associated with the 
login name . 


Ordinary users may change only the password which corresponds 
to their login name . 


Passwd prompts ordinary users for their old password, if any. It 
then prompts for the new password twice. The first time the new 
password is entered passwd checks to see if the old password has 
“aged” sufficiently. If “aging” is insufficient the new password is 
rejected and passwd terminates; see passwd (4). 


Assuming “aging” is sufficient, a check is made to insure that the 
new password meets construction requirements. When the new 
password is entered a second time the two copies of the new pass- 
word are compared. If the two copies are not identical the cycle of 
prompting for the new password is repeated for at most two more 
times. — | 


Passwords must be constructed to meet the following requirements: 


Each password must have at least six characters. Only the 
first eight characters are significant. 


Each password must contain at least two alphabetic charac- 
ters and at least one numeric or special character. In this 
case, ‘alphabetic’ means upper and lower case letters. 


Each password must differ from the user's login name and 
any reverse or circular shift of that login name . For com- 
parison purposes, an upper case letter and its correspond- 
ing lower case letter are equivalent. 


New passwords must differ from the old by at least three 
characters. For comparison purposes, an upper case letter 
and its corresponding lower case letter are equivalent. 


One whose effective user ID is zero is called a super-user; see id 
(1), and su (7). Super-users may change any password; hence, 
passwd does not prompt super-users for the old password. Super- 
users are not forced to comply with password aging and password 
construction requirements. A super-user can create a null password 
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by entering a carriage return in response to the prompt for a new 
password. 


FILES 
/etc/passwd 


SEE ALSO 
login(1), id(1), su(1). 
crypt(3C), passwd(4) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 
paste — merge same lines of several files or subsequent lines of one 
file 
SYNOPSIS 
paste file1 file2 ... 
paste —dlist file1 file2 ... 
paste -—s [—dlist] file1 file2 ... 


DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the 
given input files file? , file2 , etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel 
merging). If you will, it is the counterpart of cat (7) which concaten- 
ates vertically, i.e., one file after the other. In the last form above, 
paste replaces the function of an older command with the same 
name by combining subsequent lines of the input file (serial merg- 
ing). In all cases, lines are glued together with the tab character, or 
with characters from an optionally specified fist . Output is to the 
standard output, so it can be used as the start of a pipe, or as a 
filter, if — is used in place of a file name. 


The meanings of the options are: 


—d Without this option, the new-line characters of each but the 
last file (or last line in case of the -s option) are replaced by 
a tab character. This option allows replacing the tab char- 
acter by one or more alternate characters (see below). 


list One or more characters immediately following —d repiace 
the default fab as the line concatenation character. The list 
is used circularly, i.e., when exhausted, it is reused. In 
parallel merging (i.e., no —s option), the lines from the last 
file are always terminated with a new-line character, not 
from the fist . The list may contain the special escape 
sequences: \n (new-line), \t (tab), \\ (backslash), and \0 
(empty string, not a null character). Quoting may be neces- 
sary, if characters have special meaning to the shell (e.g., 
to get one backslash, use —d"\\\\" ). 


—-S Merge subsequent lines rather than one from each input file. 
Use tab for concatenation, unless a /ist is specified with —d 
option. Regardless of the /ist , the very last character of the 
file is forced to be a new-line. 


_ May be used in place of any file name, to read a line from 
the standard input. (There is no prompting). 
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EXAMPLES 
Is | paste -d"" - list directory in one column 
Is | paste - - - - list directory in four columns 
paste —s —d'\t\n" file combine pairs of lines into lines 
SEE ALSO 


cut(1), grep(1), pr(1). 


DIAGNOSTICS 
line too long Output lines are restricted to 
911 characters. 


too many files Except for —s option, no more 
than 12 input files may be 
specified. 
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pg — file perusal filter for soft-copy terminals 


SYNOPSIS 


pg [-number] [-p string] [-cefns] [+/linenumber] [+/pattern/] [ 
files ...] 


DESCRIPTION 
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The pg command is a filter which allows the examination of files 
one screenful at a time on a soft-copy terminal. (The file name — 
and/or NULL arguments indicate that pg should read from the stan- 
dard input.) Each screenful is followed by a prompt. If the user 
types a Carriage return, another page is displayed; other possibilities 
are enumerated below. 


This command is different from previous paginators in that it allows 
you to back up and review something that has already passed. The 
method for doing this is explained below. 


In order to determine terminal attributes, pg scans the terminfo (4) 
data base for the terminal type specified by the environment vari- 
able TERM . If TERM is not defined, the terminal type dumb is 
assumed. 


The command line options are: 


—number . 
An integer specifying the size (in lines) of the window that — 
pg is to use instead of the default. (On a terminal contain- 
ing 24 lines, the default window size is 23). 


—p string 
Causes pg to use string as the prompt. If the prompt string 
contains a “%d", the first occurrence of “%d’" in the prompt 
will be replaced by the current page number when the 
prompt is issued. The default prompt string is “:”. 


on Home the cursor and clear the screen before displaying 
each page. This option is ignored if clear_screen is not 
defined for this terminal type in the terminfo (4) data base. 


—e Causes pg not to pause at the end of each file. 


—f Normally, pg splits lines longer than the screen width, but 
some sequences of characters in the text being displayed 
(e.g., escape sequences for underlining) generate undesir- 
able results. The —f option inhibits pg from splitting lines. 


—n Normaily, commands must be terminated by a <newline > 


character. This option causes an automatic end of com- ~ ~ 


mand as soon as a command letter is entered. 
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—S Causes pg to print all messages and prompts in standout 
mode (usually inverse video). 


+ linenumber 
Start up at linenumber . 


+/pattern/ 
Start up at the first line containing the regular expression 
pattern. 


The responses that may be typed when pg pauses can be divided 
into three categories: those causing further perusal, those that 
search, and those that modify the perusal environment. 


Commands which cause further perusal normally take a preceding 
address , an optionally signed number indicating the point from 
which further text should be displayed. This address is interpreted 
in either pages or lines depending on the command. A signed 
address specifies a point relative to the current page or line, and an 
unsigned address specifies an address relative to the beginning of 
the file. Each command has a default address that is used if none 
is provided. 


The perusal commands and their defaults are as follows: 
(+1)<newline > or <blank> 


This causes one page to be displayed. The address is 
specified in pages. 


(+1) 1 With a relative address this causes pg to simulate scrolling 
the screen, forward or backward, the number of lines speci- 
fied. With an absolute address this command prints a 
screenful beginning at the specified line. 

(+1) dor *D 
Simulates scrolling half a screen forward or backward. 


The following perusal commands take no address . 


. or “L 
Typing a single period causes the current page of text to be 
redisplayed. 

$ Displays the last windowful in the file. Use with caution 


when the input is a pipe. 


The following commands are available for searching for text patterns 
in the text. The regular expressions described in ed (7) are avail- 
able. They must always be terminated by a <newline>, even if the 
—n option is specified. 
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i/pattern/ 
Search forward for the / th (default / =7) occurrence of pat- 
tern . Searching begins immediately after the current page 
and continues to the end of the current file, without wrap- 
around. 


i*pattern* 

i? pattern? | 
Search backwards for the / th (default / =17) occurrence of 
pattern . Searching begins immediately before the current 
page and continues to the beginning of the current file, 
without wrap-around. The ~ notation is useful for Adds 100 
terminals which will not properly handle the ?. 


After searching, pg will normally display the line found at the top of 
the screen. This can be modified by appending m or b to the 
search command to leave the line found in the middle or at the bot- 
tom of the window from now on. The suffix t can be used to restore 
the original situation. 


The user of pg can modify the environment of perusal with the fol- 
lowing commands: 


in Begin perusing the / th next file in the command line. The / 
is an unsigned number, default value is 1. 


ip Begin perusing the / th previous file in the command line. / 
is an unsigned number, default is 1. | 


iw Display another window of text. If / is present, set the win- 
dow size to/. 


S filename | 
Save the input in the named file. Only the current file being 
perused is saved. The white space between the s and 
filename is optional. This command must always be ter- 
minated by a <newline>, even if the —n option is specified. 


h Help by displaying an abbreviated summary of available 
commands. 


q or Q 
Quit pg. 


!command 
Command is passed to the shell, whose name is taken from 
the SHELL environment variable. If this is not available, the 
default shell is used. This command must always be ter- 
minated by a <newline >, even if the —n option is specified. 


At any time when output is being sent to the terminal, the user can 
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hit the quit key (normally control-\) or the interrupt (break) key. This 
Causes pg to stop sending output, and display the prompt. The 
user may then enter one of the above commands in the normal 
manner. Unfortunately, some output is lost when this is done, due 
to the fact that any characters waiting in the terminal's output queue 
are flushed when the quit signal occurs. 


If the standard output is not a terminal, then pg acts just like cat 
(7), except that a header is printed before each file (if there is more 
than one). 


EXAMPLE 


NOTES 


FILES 


A sample usage of pg in reading system news would be 


news | pg -p "(Page %d):" 


While waiting for terminal input, pg responds to BREAK , DEL , and 
~ by terminating execution. Between prompts, however, these sig- 
nals interrupt pg ’s current task and place the user in prompt mode. 
These should be used with caution when input is being read from a 
pipe, since an interrupt is likely to terminate the other commands in 
the pipeline. 

Users of Berkeley’s more will find that the z and f commands are 


available, and that the terminal /, °, or ? may be omitted from the 
searching commands. 


428.sp20u 
/usr/lib/terminfo/* 
Terminal information data base 


/tmp/pg* 
Temporary file when input is from a pipe 


SEE ALSO 


BUGS 


crypt(1), ed(1), grep(1). 
terminfo(4) in the Sys5 UNIX Programmer Reference Manual. 


If terminal tabs are not set every eight positions, undesirable results 
may occur. 


When using pg as a filter with another command that changes the 
terminal I/O options (e.g., crypt (1)), terminal settings may not be 
restored correctly. 
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NAME 
pic — troff preprocessor for drawing simple pictures 


SYNOPSIS 
pic [| -Tt | [ files | 


DESCRIPTION 
Pic is a troff(1) preprocessor for drawing simple figures on a 
typesetter. The basic objects are box, line, arrow, circle, ellipse, 
arc and text. 


The optional argument —Tt specifies device f; currently supported 
devices are aps (Autologic APS-5), X97 (Xerox 9700), and i10 
(Imagen Imprint-10). Default is —Taps. 


SEE ALSO 
troff(1). 


PIC — A Graphics Language for Typesetting. 
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pr — print files 


SYNOPSIS 


pr [ options | [ files | 


DESCRIPTION 
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Pr prints the named files on the standard output. If file is —, or if no 
files are specified, the standard input is assumed. By default, the 
listing is separated into pages, each headed by the page number, a 
date and time, and the name of the file. 


By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the —s option is used, 
lines are not truncated and columns are separated by the separation 
character. 


lf the standard output is associated with a terminal, error messages 
are withheld until pr has completed printing. 


The below options may appear singly or be combined in any order: 
+k Begin printing with page k (default Is 1). 


—K Produce k -column output (default is 1). The options -e 
and —i are assumed for multi-column output. 

—a Print multi-column output across the page. 

—-m Merge and print all files simultaneously, one per column 


(overrides the —k, and —a options). 
-d Double-space the output. 


—eck Expand input tabs to character positions k +1, 2* k +1, 3x 
k +17, etc. If k is 0 or is omitted, default tab settings at 
every eighth position are assumed. Tab characters in the 
input are expanded into the appropriate number of spaces. 
If c (any non-digit character) is given, it is treated as the 
input tab character (default for c is the tab character). 


-ick In output , replace white space wherever possible by insert- 
ing tabs to character positions k +1, 2* kK +1, 3* k +1, etc. 
lf k is O or is omitted, default tab settings at every eighth 
position are assumed. If c (any non-digit character) is 
given, it is treated as the output tab character (default for c 
is the tab character). 


—nck Provide k -digit line numbering (default for k is 5). The 
number occupies the first k +7 character positions of each 
column of normal output or each line of —m output. If c 
(any non-digit character) is given, it is appended to the line 
number to separate it from whatever follows (default for c is 
a tab). 
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-wk Set the width of a line to k character positions (default is 72 
for equal-width multi-column output, no limit otherwise). 

-—ok Offset each line by k character positions (default is 0). The 

| number of character positions per line is the sum of the 
width and offset. 

—Ik Set the length of a page to k lines (default is 66). 

—h Use the next argument as the header to be printed instead 
of the file name. 

—p Pause before beginning each page if the output is directed 
to a terminal (pr will ring the bell at the terminal and wait for 
a Carriage return). 

—f Use form-feed character for new pages (default is to use a 
sequence of line-feeds). Pause before beginning the first 
page if the standard output is associated with a terminal. 

—r Print no diagnostic reports on failure to open files. 

—t Print neither the five-line identifying header nor the five-line 

| trailer normally supplied for each page. Quit printing after 
the last line of each file without spacing to the end of the 
page. 

-SC Separate columns by the single character c instead of by 
the appropriate number of spaces (default for c is a tab). 

EXAMPLES 

Print file1 and file2 as a double-spaced, three-column listing 

headed by ‘Tile list”: 
pr —3dh ‘file list” file1 file2 

Write file1 on file2 , expanding tabs to columns 10, 19, 28, 37,...: 
pr -e9 -t <file1 >file2 

FILES 

/dev/tty* to suspend messages 
SEE ALSO 

cat(1). 
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NAME 

printenv — print out the environment 
SYNOPSIS 

/usr/plx/printenv [ name ] 
DESCRIPTION 


Printenv prints out the values of the variables in the environment. If 
a name is specified, only its value is printed. 


lf a name is specified and it is not defined in the environment, prin- 
tenv returns exit status 1, else it returns status O. 


NOTES 
This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
sh(1), environ(5), csh(1). 
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NAME 


prof — display profile data 


SYNOPSIS 


prof [-tcan] [—ox] (-g] [-z] [-h] [-s] [-m mdata] [prog] 


DESCRIPTION 
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Prof interprets a profile file produced by the monitor (3C) function. 
The symbol table in the object file prog (a.out by default) is read 
and correlated with a profile file (mon.out by default). For each 
external text symbol the percentage of time spent executing 
between the address of that symbol and the address of the next is 
printed, together with the number of times that function was called 
and the average number of milliseconds per call. 


The mutually exclusive options t, c, a, and n determine the type of 
sorting of the output lines: 


—t Sort by decreasing percentage of total time (default). 
—C Sort by decreasing number of calls. 

—a Sort by increasing symbol address. 

-—n Sort lexically by symbol name. 


The mutually exclusive options o and x specify the printing of the 
address of each symbol monitored: 


—O Print each symbol address (in octal) along with the symbol 
name. 
—X Print each symbol address (in hexadecimal) along with the 


symbol name. 
The following options may be used in any combination: 
-g Include non-global symbols (static functions). 


-Z Include all symbols in the profile range (see monitor (3C)), 
even if associated with zero number of calls and zero time. 


—h Suppress the heading normally printed on the report. (This 
is useful if the report is to be processed further.) 


-S Print a summary of several of the monitoring parameters 
and statistics on the standard error output. 


—m mdata 
Use file mdata instead of mon.out as the input profile file. 


A program creates a profile file if it has been loaded with the —p 
option of cc (7). This option to the cc command arranges for calls 
to monitor (3C) at the beginning and end of execution. It is the call 
to monitor at the end of execution that causes a profile file to be 
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FILES 


written. The number of calls to a function is tallied if the —p option 
was used when the file containing the function was compiled. 


The name of the file created by a profiled program is controlled by 
the environment variable PROFDIR. If PROFDIR does not exist, 
“mon.out” is produced in the directory current when the program 
terminates. If PROFDIR = string, “string pid.progname’” is produced, 
where progname consists of argv[O] with any path prefix removed, 
and pid is the program's process id. If PROFDIR = nothing, no pro- 
filing Output is produced. 


A single function may be split into subfunctions for profiling by 
means of the MARK macro (see prof (5)). 


mon.out for profile 
a.out for namelist 


SEE ALSO 


cc(1). 
exit(2), profil(2), monitor(3C), prof(5) in the Sys5 UNIX Programmer 
Reference Manual. 


WARNING 


BUGS 


The times reported in successive identical runs may show variances 
of 20% or more, because of varying cache-hit ratios due to sharing 
of the cache with other processes. Even if a program seems to be 
the only one using the machine, hidden background or asynchro- 
nous processes may blur the data. In rare cases, the clock ticks ini- 
tiating recording of the program counter may “beat” with loops in a 
program, grossly distorting measurements. 


Call counts are always recorded precisely, however. 


Only programs that call exit (2) or return from main will cause a pro- 
file file to be produced, unless a final call to monitor is explicitly 
coded. 


The use of the -p option cc (7) to invoke profiling imposes a limit of 
600 functions that may have call counters established during pro- 
gram execution. For more counters you must call monitor (3C) 
directly. If this limit is exceeded, other data will be overwritten and 
the mon.out file will be corrupted. The number of call counters 
used will be reported automatically by the prof command whenever 
the number exceeds 5/6 of the maximum. 
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prs — print an SCCS file 


SYNOPSIS 


prs [-—d[dataspec]] [-r[S!ID]] [-e] [-!] [-c[date-time]] [—a] files 


DESCRIPTION 
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Prs prints, on the standard output, parts or all of an SCCS file (see 
sccsfile (4)) in a user-supplied format. If a directory is named, prs 
behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path 
name does not begin with s.), and unreadable files are silently 
ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file or 
directory to be processed; non-SCCS files and unreadable files are 
silently ignored. 


Arguments to prs , which may appear in any order, consist of 
keyletter arguments, and file names. 


All the described keyletter arguments apply independently to each 
named file: 


—d[dataspec] Used to specify the output data specification. | 
The dataspec is a string consisting of SCCS 
file data keywords (see DATA KEYWORDS ) 
interspersed with optional user supplied text. 


—r[S/D] Used to specify the S CCS ID entification 
(SID) string of a delta for which information is 
desired. If no SID is specified, the SID of the 
most recently created delta is assumed. -e 
and -l keyletters. The format for the date is: 
mmiddiyy [hh:mm:ss]. 


—e Requests information for all deltas created 
earlier than and including the delta desig- 
nated via the -r keyletter or the date given by 
the —c option. 


—| Requests information for all deltas created 
later than and including the delta designated 
via the -r keyletter or the date given by the 
—C option. 

(—c[cutoff]] Cutoff date-time, in the form: 


YY[MM[DD{[HH[MMISSIIj]] 
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-c[date-time| Units omitted from the date-time default to 
their maximum possible values; that is, 
-c7502 is equivalent to -—c750228235959. 
Any number of non-numeric characters may 
separate the various 2-digit pieces of the cut- 
off date in the form: "“-e77/2/2 9:22:25". 


—a Requests printing of information for both 
removed, i.e., delta type = R, (see rmdel 
(1)) and existing, i.e., delta type = D, deltas. 
If the —a keyletter is not specified, information 
for existing deltas only is provided. 


DATA KEYWORDS 


Data keywords specify which parts of an SCCS file are to be 
retrieved and output. All parts of an SCCS file (see sccsfile (4)) 
have an associated data keyword. There is no limit on the number 
of times a data keyword may appear in a dataspec . 


The information printed by prs consists of: (1) the user-supplied 


~ text; and (2) appropriate values (extracted from the SCCS file) sub- 


stituted for the recognized data keywords in the order of appear- 
ance in the dataspec. The format of a data keyword value is either 
Simple (S), in which keyword substitution is direct, or Multi-line (M), 
in which keyword substitution is followed by a carriage return. 


User-supplied text is any text other than recognized data keywords. 

A tab is specified by \t and carriage return/new-line is specified by 

\n. The default data keywords are: 
":Dtat:bL:\nMRs:\n:MR:COMMENTS:\n:C:" 


TABLE 1. SCCS Files Data Keywords 


KeywordData Item File Section Value Format 
:Dt: Delta information Delta Table See below* S 
:DL: Delta line statistics i :Li:/:Ld:/:Lu: Ss 
:Li: Lines inserted by Delta | nnnann Ss 
:Ld: Lines deleted by Delta : nnnann S 
:-Lu: Lines unchanged by Delta me nnannn S 
:DT: Delta type " DorR S 

1: SCCS ID string (SID) " “Rick. BiS: S 
-R: Release number ‘ nnnn S 
:L: Level number u  mnnnn S) 
:B: Branch number " nnnn Ss 
1S: Sequence number : nnnn S 
:D: Date Delta created ‘Dy:/:Dm:/:Dd: S$ 
:Dy: Year Delta created : ‘ nn s~ 
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:Dm: 
:Dd: 
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Month Delta created 

Day Delta created 

Time Delta created 

Hour Delta created 
Minutes Delta created 
Seconds Delta created 
Programmer who Created Delta 
Deita sequence number 
Predecessor Delta seq-no. 
Seq-no. of deltas incl., exci., ignored 
Deltas included (seq #) 
Deltas excluded (seq #) 
Deltas ignored (seq #) 
MR numbers for delta 
Comments for delta 

User names 

Flag list 

Module type flag 

MR validation flag 

MR validation pgm name 
Keyword error/warning flag 
Keyword validation string 
Branch flag 

Joint edit flag 

Locked releases 

User defined keyword 
Module name 

Floor boundary 

Ceiling boundary 

Default SID 

Null delta flag 

File descriptive text 

Body 

Gotten body 

A form of what(1) string 

A form of what(1) string 
what(1) string delimiter 
SCCS file name 

SCCS file path name 


* :Dt: = :DT: :l: :D: :T: :P: :DS: :DP: 


User Names 
Flags 


Comments 
Body 


PRS(1) 


nn 
nn 
:Th:::Tm:::Ts: 
nn 
nn 
nn 
logname 
nnann 
nnnn 
:Dn:/:Dx:/:Dg: 
:DS: :DS:... 
:-DS: :DS:... 
:-DS: :DS:... 
text 
text 
text 
text 
text 
yes or no 
text 
yes or no 
text 
yes or no 
yes or no 
7R:... 
text 
text 
:-R: 
R: 
A: 
yes or no 
text 
text 
text 
-Z::MAtil: 
iZ2::¥: iM: 21::Z: 
@(#) 
text 
text 
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EXAMPLES 
prs —d"Users and/or user IDs for :F: are:\n:UN:" s.file 


may produce on the standard output: 


Users and/or user IDs for s.file are: 
XyZ 
131 
abc 


ors —d"Newest delta for pgm :M:: :l: Created :D: By :P:" -r 
S.file 


may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12'1 By cas 
As a special case: | 

ors S.file 
may produce on the standard output: 


D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00C000 
MRs: | 
bI78-12345 

bI79-54321 

COMMENTS: 

this is the comment line for s.file initial delta 


for each delta table entry of the “D” type. The only keyletter argu- 
ment allowed to be used with the special case is the —a keyletter. 


FILES 


SEE ALSO 
admin(1), delta(1), get(1), help(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 


Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 


DIAGNOSTICS 
Use help (7) for explanations. 
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NAME 
ps — report process status 
SYNOPSIS 
ps [ options ] 
DESCRIPTION 
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Ps prints certain information about active processes. Without 
options , information is printed about processes associated with the 
current terminal. The output consists of a short listing containing 
only the process ID, terminal identifier, cumulative execution time, 
and the command name. Otherwise, the information that is 
displayed is controlled by the selection of options . 


Options using lists as arguments can have the list specified in one 
of two forms: a list of identifiers separated from one another by a 
comma, or a list of identifiers enclosed in double quotes and 
separated from one another by a comma andor one or more 
Spaces. 


The options are: 


—e Print information about all processes. 

—d Print information about all processes, except process 
group leaders. 

-a Print information about all processes, except process 
group leaders and processes not associated with a ter- 
minal. 

—f Generate a full listing. (See below for meaning of 


columns in a full listing). 

| Generate a /ong listing. See below. 

-c corefile Use the file corefile in place of /dev/mem . 

—S swapdev Use the file swapdev in place of /dev/swap . This is 
useful when examining a corefile ; a swapdev of 
/dev/null will cause the user block to be zeroed out. 

—n namelist The argument will be taken as the name of an alter- 
nate system nameliist file in place of /unix. 

-t termlist Restrict listing to data about the processes associated 
with the terminals given in fermiist . Terminal identifiers 
may be specified in one of two forms: the device's file 
name (e.g., ttyO04) or if the device's file name starts 
with tty, just the digit identifier (e.g., 04). 

-p prociist Restrict listing to data about processes whose process 
ID numbers are given in prociist . 

—u Uuidlist Restrict listing to data about processes whose user ID 
numbers or login names are given in uidilist . In the 
listing, the numerical user ID will be printed unless the 


May 27, 1985 


PS(1) 


UNIX Sys5 PS(1) 


—f option is used, in which case the login name will be 
printed. 

-—g grplist Restrict listing to data about processes whose process 
group leaders are given in grpiist . 


The column headings and the meaning of the columns in a ps list- 
ing are given below; the letters f and | indicate the option (full or 
fong ) that causes the corresponding heading to appear; all means 
that the heading always appears. Note that these two options 
determine only what information is provided for a process; they do 
not determine which processes will be listed. 


F (1) 
S (I) 
UID (f,1) 
PID (all) 
PPID (f,1) 
C (f,1) 
PRI (I) 
Ni (I) 
ADDR (I) 
SZ (I) 
WCHAN (I) 
May 27, 1985 


Flags (octal and additive) associated with the pro- 
cess: 


0 swapped; 

1 in core; 

2 system process; 

4 locked-in core (e.g., for physical I/O); 


10 being swapped; 
20 being traced by another process; 
40 another tracing flag; — 
The state of the process: 
0 non-existent; 
S sleeping; 
W waiting; 
R running; 
| intermediate; 
Z terminated; 
F stopped; 
X growing. 
The user ID number of the process owner; the 
login name is printed under the —f option. 
The process !D of the process; it is possible to kill 
a process if you know this datum. 
The process ID of the parent process. 
Processor utilization for scheduling. 
The priority of the process; higher numbers mean 
lower priority. 
Nice value; used in priority computation. 
The memory address of the process if resident; 
otherwise, the disk address. 
The size in blocks of the core image of the pro- 
cess. 
The event for which the process is waiting or 
sleeping; if blank, the process is running. 
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FILES 


SEE AL 


BUGS 
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STIME  (f) 

TTY (all) 
TIME (all) 
CMD (all) 
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Starting time of the process. 

The controlling terminal for the process. 

The cumulative execution time for the process. 
The command name; the full command name and 
its arguments are printed under the —f option. 


A process that has exited and has a parent, but has not yet been 
waited for by the parent, is marked <defunct> . 


Under the -f option, ps tries to determine the command name and 
arguments given when the process was created by examining 
memory or the swap area. Failing this, the command name, as it 
would appear without the -f option, Is printed in square brackets. 


/ UNIX system nameiist 

‘devimem memory 

‘dev.swap _ the default swap device 

-etc‘passwd supplies UID information 

/etc ps_data_ internal data structure 

‘dev searched to find terminal (“tty”) names 


SO 


acctcom(1), kill(1), nice(1). 


Things can change while ps is running; the picture it gives is only a 
close approximation to reality. Some data printed for defunct 
processes are irrelevant. 
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NAME 
ptx — permuted index 


SYNOPSIS 
ptx [ options | [ input [ output |] | 


DESCRIPTION 

Ptx generates the file output that can be processed with a text for- 
matter to produce a permuted index of file input (standard input and 
output default). It has three phases: the first does the permutation, 
generating one line for each keyword in an input line. The keyword 
is rotated to the front. The permuted file is then sorted. Finally, the 
sorted lines are rotated so the keyword comes at the middle of each 
line. Ptx output is in the form: 


.xx "tail" "before keyword" "keyword and after” “head” 


where .xx is assumed to be an nroff or troff (1) macro provided by 
the user, or provided by the mptx (5) macro package. The before 
keyword and keyword and after fields incorporate as much of the 
line as will fit around the keyword when it is printed. Tail and head , 
at least one of which is always the empty string, are wrapped- 
around pieces small enough to fit in the unused space at the oppo- 
site end of the line. 


The following options can be applied: 


—f Fold upper and lower case letters for sorting. 
-t Prepare the output for the phototypesetter. 
-wn Use the next argument, n, as the length of the output 


line. The default line length is 72 characters for nroff 
and 100 for troff . 


-gn Use the next argument, n , as the number of characters 
that ptx will reserve in its calculations for each gap 
among the four parts of the line as finally printed. The 
default gap is 3. 


—O only Use as keywords only the words given in the only file. 


-i ignore Do not use as keywords any words given in the ignore 
file. If the -i and -o options are missing, use 
- /usr/lib/eign as the ignore file. 


-—b break Use the characters in the break file to separate words. 
Tab, new-line, and space characters are a/ways used 
as break characters. 
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-r Take any leading non-blank characters of each input 
line to be a reference identifier (as to a page or 
chapter), separate from the text of the line. Attach that 
identifier as a 5th field on each output line. 


The index for this manual was generated using pix . 


FILES 
/bin/sort 
/usr/lib/eign 
/usr/lib/tmac/tmac.ptx 
SEE ALSO 
nroff(1), troff(1). 
mm(5), mptx(5) in the Sys5 UNIX Programmer Reference Manual. 


BUGS 
Line length counts do not account for overstriking or proportional 
spacing. 
Lines that contain tildes (~() are botched, because ptx uses that 
character internally. 
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NAME 
pwd — working directory name 


SYNOPSIS 
pwd 


DESCRIPTION 


PWD(1) 


Pwd prints the path name of the working (current) directory. 


SEE ALSO 
cd(1). 


DIAGNOSTICS 


“Cannot open ..” and “Read error in ..” indicate possible file system 
trouble and should be referred to a UNIX system programming coun- 


Selor. 
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NAME 
( ratfor — rational Fortran dialect 
SYNOPSIS 
ratfor [ options | [ files ] 
DESCRIPTION 
Ratfor converts a rational dialect of Fortran into ordinary irrational 
Fortran. Ratfor provides control flow constructs essentially identical 
to those in C: 
statement grouping: 
{ statement; statement; statement } 
decision-making: 
if (condition) statement [ else statement | 
switch (integer value) { 
case integer: statement 
[ default: ] statement 
} 
loops: 
while (condition) statement 
— for (expression; condition; expression) statement 
( do limits statement 
Mca repeat statement [ until (condition) | 
break 
next 


and some syntactic sugar to make programs easier to read and 
write: 


free form input: 
multiple statements, line; automatic continuation 


comments: 
# this is a comment. 


translation of relationals: 
>, >=, etc., become .GT. , .GE. , etc. 


return expression to caller from function: 
return (expression) 


define: 
define name replacement 


include: 
include file 
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The option —h causes quoted strings to be turned into 27H con- 
structs. The —C option copies comments to the output and attempts 
to format it neatly. Normally, continuation lines are marked witha & 
in column 1; the option -6x makes the continuation character x and 
places it in column 6. 


Ratfor is best used with f77 (7). 
SEE ALSO 
efl(1), f77(1). 


B. W. Kernighan and P. J. Plauger, Software Tools , Addison- 
Wesley, 1976. 
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NAME 


regcmp — regular expression compile 


SYNOPSIS 


regcmp [ — | files 


DESCRIPTION 


Regcmp , in most cases, precludes the need for calling regcmp 
(3X) from C programs. This saves on both execution time and pro- 
gram size. The command regcmp compiles the regular expres- 
sions in file and places the output in file.i. If the - option is used, 
the output will be placed in file.c. The format of entries in file is a 
name (C variable) followed by one or more blanks followed by a reg- 
ular expression enclosed in double quotes. The output of regcmp is 
C source code. Compiled regular expressions are represented as 
extern char vectors. File.i files may thus be included into C pro- 
grams, or file.c files may be compiled and later loaded. In the C 
program which uses the regcomp output, regex ( abc , fine ) will 
apply the regular expression named abc to line . Diagnostics are 
self-explanatory. 


EXAMPLES 


name "([A—Za—z][A—Za—z0—9_]*)$0" 


telno —"\({0,1}([2-9][01][1—-9])$0\){0, 1} *" 
“([2-9][0-9}{2})$1[ 10,17" 
“((0-9]147)$2" 


In the C program that uses the regcmp output, 
regex(telno, line, area, exch, rest) 


will apply the regular expression named fe/no to line. 


SEE ALSO 
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regcmp(3X) in the Sys5 UNIX Programmer Reference Manual. 
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rm, rmdir — remove files or directories 


SYNOPSIS 


rm | —fri | file ... 


rmdir dir ... 


DESCRIPTION 


Rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 


If a file has no write permission and the standard input is a terminal, 
its permissions are printed and a line is read from the standard 
input. If that line begins with y the file is deleted, otherwise the file 
remains. No questions are asked when the -f option is given or if 
the standard input is not a terminal. 


lf a designated file is a directory, an error comment is printed unless . 


the optional argument -r has been used. In that case, rm recur- 
sively deletes the entire contents of the specified directory, and the 
directory itself. 


If the -i (interactive) option is in effect, rm asks whether to delete 
each file, and, under -r , whether to examine each directory. 


Rmdir removes entries for the named directories, which must be 
empty. 


SEE ALSO 


unlink(2) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 
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Generally self-explanatory. It is forbidden to remove the file .. 
merely to avoid the antisocial consequences of inadvertently doing 
something like: 


rm —f .* 
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NAME 


rmdel — remove a delta from an SCCS file 


SYNOPSIS 


rmdel —rSID files 


DESCRIPTION 


Rmdel removes the delta specified by the S/D from each named 
SCCS file. The delta to be removed must be the newest (most 
recent) delta in its branch in the delta chain of each named SCCS 
file. In addition, the specified must not be that of a version being 
edited for the purpose of making a delta (i. e., if a p-file (see get 
(1)) exists for the named SCCS file, the specified must not appear 
in any entry of the p-file). 


If a directory is named, rmde/ behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files 
(last Component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of — is given, the 
standard input is read; each line of the standard input is taken to be 
the name of an SCCS file to be processed; non-SCCS files and 
unreadable files are silently ignored. | 


The exact permissions necessary to remove a delta are docu- 
mented in the Source Code Control System User Guide . Simply 
stated, they are either (1) if you make a delta you can remove it; or 
(2) if you own the file and directory you can remove a delta. 


FILES 
x.file (see delta (1)) 
z.file (see delta (7)) 
SEE ALSO 
delta(1), get(1), help(1), prs(1). 
sccsfile(4) in the Sys5 UNIX Programmer Reference Manual. 
Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 
DIAGNOSTICS 
Use help (7) for explanations. 
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sact — print current SCCS file editing activity 


SYNOPSIS 
sact files 


DESCRIPTION 


Sact informs the user of any impending deltas to a named SCCS 
file. This situation occurs when get (7) with the —-e option has been 
previously executed without a subsequent execution of delta (7). If 
a directory is named on the command line, sacf behaves as though 
each file in the directory were specified as a named file, except that 
non-SCCS files and unreadable files are silently ignored. If a name 
of — is given, the standard input is read with each line being taken 
as the name of an SCCS file to be processed. 


The output for each named file consists of five fields separated by 


spaces. 
Field 1 


Field 2 
Field 3 


Field 4 
Field 5 
SEE ALSO 


specifies the SID of a delta that currently exists in 
the SCCS file to which changes will be made to 
make the new delta. 


specifies the SID for the new delta to be created. 


contains the logname of the user who will make 
the delta (i.e., executed a get for editing). 


contains the date that get -e was executed. 
contains the time that get -e was executed. 


delta(1), get(1), unget(1). 


DIAGNOSTICS 


Use help (1) for explanations. 
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NAME 


sag — system activity graph 


SYNOPSIS 


Sag [ options | 


DESCRIPTION 
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Sag graphically displays the system activity data stored in a binary 
data file by a previous sar (7) run. Any of the sar data items may 
be plotted singly, or in combination; as cross plots, or versus time. 
Simple arithmetic combinations of data may be specified. Sag 
invokes sar and finds the desired data by string-matching the data 
column header (run sar to see what is available). These options are 
passed through to sar : | 


-s time Select data later than fime in the form hh[:mm]. Default 
is 08:00. 


-—e time Select data up to time . Default is 18:00. 


—i SEC Select data at intervals as close as possible to sec 
seconds. 


—f file Use file as the data source for sar. Default is the current 
daily data file /usr/adm/sa/sadd. 


Other options: 


-T term Produce output suitable for terminal term. See tplot(1G) 
for known terminals. If ferm is vpr , output is processed 
by vpr —p and queued to a Versatec printer. Default for 
term is $TERM . 


-X Spec x axis specification with spec in the form: 
"name [op name]...[lo hil" 


-y spec y axis specification with spec in the same form as above. 


Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, e.g., 
r+w/s[dsk-1], or an integer value. Op is + — * or / surrounded 
by blanks. Up to five names may be specified. Parentheses are 
not recognized. Contrary to custom, + and -— _ have pre- 
cedence over * and / . Evaluation is left to right. Thus 
A/A + B * 100 IS evaluated (A/(A+ B))*100, and 
A+ B/C + D is (A+B)/(C+D). Lo and hi are optional 
numeric scale limits. If unspecified, they are deduced from the data. 


A single spec is permitted for the x axis. If unspecified, time is 
used. Up to 5 spec's separated by ; may be given for —y . Enclose 
the -x and -y arguments in "" if blanks or \<CR> are included. 
The —y default is: 
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-y “%usr 0 100; %usr + %sys 0 100; %usr + %sys + 


*wio 0 100” i 
EXAMPLES | - 
To see today’s CPU utilization: 
sag 


To see activity over 15 minutes of all disk drives: | 
TS=*date +%H:%M> 
sar —o tempfile 60 15 
TE=‘date +%H:% 
sag -f tempfile -s $TS -e $TE -y 'r+ws[dsk]" 
FILES 
/usr/adm:sa sadd daily data file for day dd. 


SEE ALSO 
sar(1), tplot(1G). 
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sar — system activity reporter 


SYNOPSIS 


sar [—ubdycwaqvmA] [-o file] t [ n ] 
sar [—ubdycwaqvmA | [-s time] [-e time] [-i sec] [-f file] 


DESCRIPTION 
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Sar, in the first instance, samples cumulative activity counters in the 
operating system at n intervals of f seconds. If the -o option is 
specified, it saves the samples in file in binary format. The default 
value of n is 1. In the second instance, with no sampling interval 
specified, sar extracts data from a previously recorded file, either 
the one specified by -f option or, by default. the standard system 
activity daily data file /usr/adm,sa’sadd for the current day dd. The 
Starting and ending times of the report can be bounded via the -s 
and -e time arguments of the form hh [: mm [: ss ]]. The -i option 
selects records at sec second intervals. Otherwise, all intervals 
found in the data file are reported. 


In either case, subsets of data to be printed are specified by option: 


—u Report CPU utilization (the default): 

Y%usr, YSys, %wid, %idle — portion of time running in user 
mode, running in system mode, idle with some process waiting 
for block lO, and otherwise idle. 

-b Report buffer activity: 
bread’s, bwrit/s — transfers per second of data between sys- 
tem buffers and disk or other block devices; 
lread’s, lwrit/s — accesses of system buffers; 

Yorcache, %wcache — cache hit ratios, e. g., 1 — bread lread; 
pread’s, pwrit/s — transfers via raw (physical) device mechan- 
ism. 

-d Report activity for each block device, e. g., disk or tape drive: 
%obusy, avque — portion of time device was busy servicing a 
transfer request, average number of requests outstanding dur- 
ing that time; 
r+w/s, blks‘s — number of data transfers from or to device, 
number of bytes transferred in 1024-byte units; 
avwait, avserv — average time in ms. that transfer requests 
wait idly on queue, and average time to be serviced (which for 
disks includes seek, rotational latency and data transfer 
times). 

-y Report TTY device activity: 
rawch/s, canch/s, outch/s — input character rate, input charac- 
ter rate processed by canon, output character rate; 
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revinis, xmtin/s, mdmin/s — receive, transmit and modem inter- 
rupt rates. 

Report system calls: 

scall/s — system calls of all types; 

sread’s, swrit/s, fork’s, execs — specific system calls; 

rchar/s, wchar’s — characters transferred by read and write 
system calls. 

Report system swapping and switching activity: 

swpin’s, swpot’s, bswin.s, bswot's — number of transfers and 
number of 1024-byte units transferred for swapins (including 
initial loading of some programs) and swapouts; 

pswch,s — process switches. 

Report use of file access system routines: 

iget/s, namets, dirbik/s. 

Report average queue length while occupied, and % of time 
occupied: 

runq-Sz, %runocc — run queue of processes in memory and 
runnable; 

swpq-sz, %Swpocc — swap queue of processes swapped out 
but ready to run. 

Report status of text, process, inode and file tables: 

text-sz, proc-sz, inod-sz, file-sz — entries/size for each table, 
evaluated once at sampling point; 

text-ov, proc-ov, inod-ov, file-ov — overflows occurring between 
sampling points. 

Report message and semaphore activities: 

msg/s, sema/s — primitives per second. 

Report all data. Equivalent to -udqbwcayvm . 


To see today's CPU activity so far: 


Sar 


To watch CPU activity evolve for 10 minutes and save data: 


sar —o temp 60 10 


To later review disk and tape activity from that period: 


FILES 


sar —d -f temp 


‘usr/adm/sa/sadd daily data file, where dd are digits representing 
the day of the month. 


SEE ALSO 


sag(1G). 
sar(1M) in the Sys5 UNIX Administrator Reference Manual. 
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scc — C compiler for stand-alone programs 


SYNOPSIS 


sec [ +[ lib ] ] [ option ] ... [ file ] ... 


DESCRIPTION 


Scc prepares the named files for stand-alone execution. The 
option and file arguments may be anything that can legally be used 
with the cc command; it should be noted, though, that the —p (profil- 
ing) option, as well as any object module that contains system calls, 
will cause the executable not to run. 


Scc defines the compiler constant, STANDALONE, so that sections 
of C programs may be compiled conditionally when the executable 
will be run stand-alone. 


lf no +/ib argument is specified, +A is assumed. If the + argu- 
ment is specified alone, no configuration library is loaded unless the 
user supplies his own. 


FILES 
Nib/crt2.0 execution start-off 
/usr/lib/lib2.a stand-alone library 
/usr/lib/lib2A.a +A configuration library 
SEE ALSO 
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cc(1), Id(1). 
a.out(4) in the UNIX System Programmer Reference Manual. 
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_ NAME 
( sccsdiff — compare two versions of an SCCS file 


SYNOPSIS 
sccsdiff -r SID1 -r SID2 [—-p] [-sn] files 


DESCRIPTION 
Sccsdiff compares two versions of an SCCS file and generates the 
differences between the two versions. Any number of SCCS files 
may be specified, but arguments apply to all files. 


—rSiD? SID1 and SID2 specify the deltas of an SCCS 
file that are to be compared. Versions are 
passed to bdiff (7) in the order given. 


—p pipe output for each file through pr (7). 


—sn n is the file segment size that bdiff will pass to 
diff (1). This is useful when diff fails due to a 
high system load. 


FILES 


SEE ALSO 
bdiff(1), get(1), help(1), pr(1). 


( Source Code Control System User Guide in the Sys5 UNIX User 
Guide . 
DIAGNOSTICS | 
“file: No differences” If the two versions are the same. 


Use help (1) for explanations. 
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NAME 


script — make typescript of terminal session 


SYNOPSIS 


/usr/plx/script [ —n ] [ -s ] [ -a ] [ -q ] [ -S shell ] [ file ] 


DESCRIPTION 


NOTES 


BUGS 
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Script makes a typescript of everything printed on your terminal. 
The typescript is saved in a file, and can be sent to the line printer 
later with /pr. If a file name is given, the typescript is saved there. If 
not, the typescript is saved in the file typescript. 


To exit script, type control D. This sends an end of file to all 
processes you have started up, and causes script to exit. For this 
reason, control D behaves as though you had typed an infinite 
number of control D's. | 


This program is useful when using a CRT and a hard-copy record of 
the dialog is desired, as for a student handing in a program that was 
developed on a CRT when hard-copy terminals are in short supply. 


The options control what shell is used. -n asks for the new shell, 
-§ asks for the standard shell. ~—S lets you specify any shell you 
want. The default depends on the system: .bin.sh is used where 
possible, otherwise /bin/sh. lf the requested shell is not available, 
Script uses any shell it can find. 


The -—q flag asks for “quiet mode”, where the “script started” and 
“script done” messages are turned off. The —a flag causes script to 
append to the typescript file instead of creating a new file. 


This command is based on a similar one from the University of Calli- 
fornia at Berkeley. 


Since UNIX has no way to write an end-of-file down a pipe without 
closing the pipe, there is no way to simulate a single control D 
without ending script. 


The new shell has its standard input coming from a pipe rather than 
a tty, so stty will not work, and neither will ttyname. 


When the user interrupts a printing process, script attempts to flush 
the output backed up in the pipe for better response. Usually the 
next prompt also gets flushed. 
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NAME 
sdiff — side-by-side difference program 
SYNOPSIS 
sdiff [ options ... ] file1 file2 
DESCRIPTION 
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Sdiff uses the output of diff (7) to produce a side-by-side listing of 
two files indicating those lines that are different. Each line of the 
two files is printed with a blank gutter between them if the lines are 
identical, a < in the gutter if the line only exists in file? , a > in the 
gutter if the line only exists in file2 , and a | for lines that are dif- 


ferent. 


For example: 


X y 

a a 

b ae 

C ee 

d d 
> C 


The following options exist: 


-—W fl 


—| 
-S 
-O output 


Use the next argument, n , as the width of the output 
line. The default line length is 130 characters. 


Only print the left side of any lines that are identical. 
Do not print identical lines. 


Use the next argument, output , as the name of a third 
file that is created as a user-controlled merging of file7 
and file2 . Identical lines of file? and file2 are copied to 
output . Sets of differences, as produced by diff (7), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a % and waits for one of the 
following user-typed commands: 


append the left column to the output 


file 

r append the right column to the output 
file 

Ss turn on silent mode; do not print identi- 
cal lines 

v turn off silent mode 
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e | call the editor with the left column 
er call the editor with the right column 


eb call the editor with the concatenation 
of left and right 


call the editor with a zero length file 


q exit from the program 


On exit from the editor, the resulting file is concatenated 
on the end of the output file. 


SEE ALSO 
diff(1), ed(1). 
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NAME 
sed — stream editor 


SYNOPSIS 
sed [ —-n | [ -e script ] [ -f sfile ] [ files ] 


DESCRIPTION 

Sed copies the named files (standard input default) to the standard 
output, edited according to a script of commands. The -f option 
causes the script to be taken from file sfile ; these options accumu- 
late. If there is just one -e option and no -f options, the flag —e 
may be omitted. The —n option suppresses the default output. A 
script consists of editing commands, one per line, of the following 
form: 


{[ address [ , address | ] function [ arguments ] 


In normal operation, sed cyclically copies a line of input into a paf- 
tern space (unless there is something left after a D commana), 
applies in sequence all commands whose addresses select that 
pattern space, and at the end of the script copies the pattern space 
to the standard output (except under —n ) and deletes the pattern 
space. 


some of the commands use a hold space to save all or part of the 
pattern space for subsequent retrieval. 


An address is either a decimal number that counts input lines cumu- 
latively across files, a $ that addresses the last line of input, or a 
context address, i.e., a /regular expression/ in the style of ed (7) 
modified thus: 


In a context address, the construction \?regular expres- 
sion?, where ? is any character, is identical to /reg- 
ular expression/. Note that in the context address 
\xabc\xdefx , the second x stands for itself, so that 
the regular expression is abcxdef . 

The escape sequence \n matches a new-line embedded in 
the pattern space. 

A period . matches any character except the terminal new- 
line of the pattern space. 

A command line with no addresses selects every pattern 
space. 

A command line with one address selects each pattern 
space that matches the address. 

A command line with two addresses selects the inclusive 
range from the first pattern space that matches the 
first address through the next pattern space that 
matches the second. (lf the second address is a 
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number less than or equal to the line number first 
selected, only one line is selected.) Thereafter the 
process is repeated, looking again for the first 
address. 


Editing commands can be applied only to non-selected pattern 
spaces by use of the negation function ! (below). 


In the following list of functions the maximum number of permissible 
addresses for each function is indicated in parentheses. 


The text argument consists of one or more lines, all but the last of 
which end with \ to hide the new-line. Backslashes in text are 
treated like backslashes in the replacement string of an Ss command, 
and may be used to protect initial blanks and tabs against the strip- 
ping that is done on every script line. The rfile or wfile argument 
must terminate the command line and must be preceded by exactly 
one blank. Each wfile is created before processing begins. There 
can be at most 10 distinct wfile arguments. 


(1) a\ 


text Append. Place text on the output before reading the 
next input line. 
(2) b " /abel” 


Branch to the : command bearing the /abe/ . If label is 
empty, branch to the end of the script. 


(2) C\ 

text Change. Delete the pattern space. With 0 or 1 address 
or at the end of a 2-address range, place text on the out- 
put. Start the next cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through 
the first new-line. Start the next cycle. 

(2)g Replace the contents of the pattern space by the con- 
tents of the hold space. 

(2)G Append the contents of the hold space to the pattern 
space. 

(2)h Replace the contents of the hold space by the contents 
of the pattern space. 

(2) H Append the contents of the pattern space to the hold 
space. 

(1) iN 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an 


unambiguous form. Non-printing characters are spelled 
in two-digit ASCII and long lines are folded. 
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(2)n Copy the pattern space to the standard output. Replace 
the pattern space with the next line of input. 

(2) N Append the next line of input to the pattern space with 
an embedded new-line. (The current line number 
changes.) 

(2)p Print. Copy the pattern space to the standard output. 

P Copy the initial segment of the pattern space through the 
first new-line to the standard output. 

(1)q Quit. Branch to the end of the script. Do not start a new 
cycle. 

(2)r rfile Read the contents of rfile . Place them on the output 
before reading the next input line. 

(2) s/ "regular expression” ‘ replacement ! flags 
Substitute the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be used instead of / . For a fuller description see ed 
(1). Flags is zero or more of: 


n n= 1-512. Substitute for just the n th 
occurrence of the regular expression. 
g Global. Substitute for all nonoverlapping 


instances of the regular expression 
rather than just the first one. 

p Print the pattern space if a replacement 
was made. 

w wiile Write. Append the pattern space to 
wile if a replacement was made. 

(2)t /abe/ Test. Branch to the : command bearing the /abe/ if any 
substitutions have been made since the most recent 
reading of an input line or execution of at . If /abel is 
empty, branch to the end of the script. 

(2) w wile Write. Append the pattern space to wiile . 

(2) x Exchange the contents of the pattern and hold spaces. 

(2) y/string1istring2 
Transform. Replace all occurrences of characters in 
string? with the corresponding character in string2 . The 
lengths of string? and string2 must be equal. 

(2)! function 
Don't. Apply the function (or group, if function is { ) only 
to lines not selected by the address(es). 

(0): /abef This command does nothing; it bears a /abe/ for b and t 
commands to branch to. 

(1) = Place the current line number on the standard output as 
a line. | 


May 27, 1985 


SED(1) UNIX Sys5 SED(1) 


(2){ Execute the following commands through a matching } 

only when the pattern space is selected. a 
(0) An empty command is ignored. — 
(0) # lf a # appears as the first character on the first line of a 


script file, then that entire line is treated as a comment, 
with one exception. If the character after the # is ann’, 
then the default output will be suppressed. The rest of 
the line after # n is also ignored. A script file must con- 
tain at least one non-comment line. 


SEE ALSO 
awk(1), ed(1), grep(1). 


a 
4 
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sh, rsh — shell, the standard/restricted command programming 
language 


SYNOPSIS 


sh [ -acefhiknrstuvx ] [ args ] 
rsh [ —acefhiknrstuvx ] [ args | 


DESCRIPTION 


Sh is a command programming language that executes commands 
read from a terminal or a file. Ash is a restricted version of the 
standard command interpreter sh ; it is used to set up login names 
and execution environments whose capabilities are more controlled 
than those of the standard shell. See /nvocation below for the 
meaning of arguments to the shell. 


Definitions 


A blank is a tab or a space. A name is a sequence of letters, digits, 
or underscores beginning with a letter or underscore. A parameter 


is a name, a digit, or any of the characters *,@, #,?,-,$, and 
Ba 


Commands 
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A simple-command is a sequence of non-blank words separated by 
blanks . The first word specifies the name of the command to be 
executed. Except as specified below, the remaining words are 
passed as arguments to the invoked command. The command 
name is passed as argument O (see exec (2)). The value of a 
simple-command is its exit status if it terminates normally, or (octal) 
200+status if it terminates abnormally (see signal (2) for a list of 
status values). 


A pipeline is a sequence of one or more commands separated by | 
(or, for historical compatibility, by ~ ). The standard output of each 
command but the last is connected by a pipe (2) to the standard 
input of the next command. Each command is run as a separate 
process; the shell waits for the last command to terminate. The exit 
status of a pipeline is the exit status of the last command. 


A list is a sequence of one or more pipelines separated by ;, & , 
&& , or | | , and optionally terminated by ; or & . Of these four sym- 
bols, ; and & have equal precedence, which is lower than that of && 
and | | . The symbols && and | | also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline; 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does not wait for that pipeline to finish). The 
symbol && (||) causes the /ist following it to be executed only if 
the preceding pipeline returns a zero (non-zero) exit status. An arbi- 
trary number of new-lines may appear in a /ist , instead of semi- 
colons, to delimit commands. 
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A command is either a simple-command or one of the following. 
Uniess otherwise stated, the value returned by a command is that of 
the last simpie-command executed in the command. 


for name [ in word ... | do list done 
Each time a for command is executed, name is set to the 
next word taken from the in word list. If in word ... is 
omitted, then the for command executes the do /ist once 
for each positional parameter that is set (see Parameter 
Substitution below). Execution ends when there are no 
more words in the list. 

case word in[ pattern [ | pattern |...) list 5; ]... esac 
A case command executes the /ist associated with the first 
pattern that matches word . The form of the patterns is the 
same as that used for file-name generation (see File Name 
Generation ) except that a slash, a leading dot, or a dot 
immediately following a slash need not be matched expli- 
citly. 

if ist then /ist [ elif ist then /ist |]... [ else list | fi 
The fist following if is executed and, if it returns a zero exit 
status, the /ist following the first then is executed. Other- 
wise, the fist following elif is executed and, if its value is 
zero, the list following the next then is executed. Failing 
that, the else fist is executed. If no else /ist or then /ist is 
executed, then the if command returns a zero exit status. 

while /ist do list done 
A while command repeatedly executes the while /ist and, if 
the exit status of the last command in the list is Zero, exe- 
cutes the do list ; otherwise the loop terminates. If no com- 
mands in the do fist are executed, then the while command 
returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 

(list) 
Execute /ist in a sub-shell. 

{list ;} 
list is simply executed. 

name {) {list;} 
Define a function which is referenced by name. The body of 
the function is the list of commands between { and }. 
Execution of functions is described below (see Execution ). 


The following words are only recognized as the first word of a com- 
mand and when not quoted: 


if then else elif fi case esac for while until do 
done { } 
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Comments 
=n A word beginning with # causes that word and all the following 
( characters up to a new-line to be ignored. 


Command Substitution 
The standard output from a command enclosed in a pair of grave 
accents (~~) may be used as part or all of a word; trailing new-lines 
are removed. 


Parameter Substitution 
The character $ is used to introduce substitutable parameters . 
There are two types of parameters, positional and keyword. If 
parameter is a digit, it is a positional parameter. Positional parame- 
ters may be assigned values by set . Keyword parameters (also 
known as variables) may be assigned values by writing: 


name =value [| name=value |... 


Pattern-matching is not performed on value . There cannot be a 
function and a variable with the same name . 


${ parameter} 
The value, if any, of the parameter is substituted. The 
braces are required only when parameter is followed by a 
| letter, digit, or underscore that is not to be interpreted as 
c part of its name. If parameter is * or @, all the positional 
( parameters, starting with $1 , are substituted (separated by 
spaces). Parameter $0 is set from argument zero when the 
shell is invoked. 
${parameter:—word} 
lf parameter is set and is non-null, substitute its value; oth- 
erwise substitute word . 
${ parameter := word} 
If parameter is not set or is null set it to word ; the value of 
the parameter is substituted. Positional parameters may 
not be assigned to in this way. 
${parameter:?word} 
If parameter is set and is non-null, substitute its value; oth- 
erwise, print word and exit from the shell. If word is omit- 
ted, the message “parameter null or not set” is printed. 
${ parameter :+ word} 
lf parameter is set and is non-null, substitute word ; other- 
wise substitute nothing. 


In the above, word is not evaluated unless it is to be used as the 
substituted string, so that, in the following example, pwd is executed 
only if d is not set or is null: 


( | echo ${d:—~ pwd>} 
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If the colon (:) is omitted from the above expressions, the shell only 
checks wheiher parameter is set or not. 


The following parameters are automatically set by the shell: 


# 


2 


$ 


i 


The number of positional parameters in decimal. 
Flags supplied to the shell on invocation or by the 
set command. 

The decimal value returned by the last synchro- 
nously executed command. 

The process number of this shell. 

The process number of the last background com- 
mand invoked. 


The following parameters are used by the shell: 
HOME The default argument (home directory) for the cd 


command. 


PATH The search path for commands (see Execution 


below). The user may not change PATH if execut- 
ing under rsh . 


CDPATH 


MAIL 


The search path for the cd command. 

If this parameter is set to the name of a mail file 
and the MAILPATH parameter is not set, the shell 
informs the user of the arrival of mail in the speci- 
fied file. 


MAILCHECK 


This parameter specifies how often (in seconds) the 
shell will check for the arrival of mail in the files 
specified by the MAILPATH or MAIL parameters. 
The default value is 600 seconds (10 minutes). If 
set to 0, the shell will check before each prompt. 


MAILPATH 


PS1 
PS2 
IFS 


A colon (:) separated list of file names. If this 
parameter is set, the shell informs the user of the 
arrival of mail in any of the specified files. Each file 
name can be followed by % and a message that will 
be printed when the modification time changes. 
The default message is you have mail . 

Primary prompt string, by default “$ ”. 

Secondary prompt string, by default “> ”. 

Internal field separators, normally space , tab , and 
new-line . 


SHACCT 
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If this parameter is set to the name of a file writable 
by the user, the shell will write an accounting record 
in the file for each shell procedure executed. 
Accounting routines such as acctcom (1) and 
acctems (1M) can be used to analyze the data 
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collected. 

SHELL When the shell is invoked, it scans the environment 
(see Environment below) for this name. If it is 
found and there is an 'r’ in the file name part of its 
value, the shell becomes a restricted shell. 


The shell gives default values to PATH, PS1, PS2, MAILCHECK and 
IFS. HOME and MAIL are set by /ogin (7). 


Biank Interpretation 


After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS ) and split into distinct arguments where such characters are 
found. Explicit null arguments ("" or * 7) are retained. Implicit null 
arguments (those resulting from parameters that have no values) 
are removed. 


File Name Generation 


Following substitution, each command word is scanned for the char- 
acters * , ?, and[ . If one of these characters appears the word Is 
regarded as a pattern . The word is replaced with alphabetically 
sorted file names that match the pattern. If no file name Is found 
that matches the pattern, the word is left unchanged. The character 
. at the start of a file name or immediately following a/, as well as 
the character / itself, must be matched explicitly. 


* Matches any string, including the null string. 

? Matches any single character. 

[ ... ] Matches any one of the enclosed characters. A 
pair of characters separated by — matches any 
character lexically between the pair, inclusive. If the 
first character following the opening ~[~° is a “!” 
any character not enclosed is matched. 


Quoting 


The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 


; & () | *~ < > new-line space tab 


A character may be quoted (i.e., made to stand for itself) by preced- 
ing it with a \ . The pair \new-line is ignored. All characters 
enclosed between a pair of single quote marks (7 ~), except a single 
quote, are quoted. Inside double quote marks (""), parameter and 
command substitution occurs and \ quotes the characters \, * , “, 
and $ . "$*" is equivalent to "$1 $2 ...", whereas "$@" is 


equivalent to "$1" "$2" .... 


Prompting 
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When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a new-line is typed and 
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further input is needed to complete a command, the secondary 
prompt (i.e., the value of PS2 ) is issued. 


Input/Output 
Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command and are not passed on to the invoked com- 
mand; substitution occurs before word or digit is used: 


<word Use file word as standard input (file descriptor Q). 

>word Use file word as standard output (file descriptor 1). 
If the file does not exist it is created; otherwise, it is 
truncated to zero length. 

>>word Use file word as standard output. If the file exists 
output is appended to it (by first seeking to the end- 
of-file); otherwise, the file is created. 

<<[-—]word The shell input is read up to a line that is the same 
as word , or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character 
of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parame- 
ter and command substitution occurs, (unescaped) 
\new-line is ignored, and \ must be used to quote 
the characters \, $ , ~ , and the first character of 
word . lf — is appended to << , all leading tabs are 
stripped from word and from the document. 


<&digit Use the file associated with file descriptor digit as 
standard input. Similarly for the standard output 
using >&digit . 

<&- The standard input is closed. Similarly for the stan- 


dard output using >&-. 


If any of the above is preceded by a digit, the file descriptor which 
will be associated with the file is that specified by the digit (instead 
of the default 0 or 1). For example: 


... 2>&1 
associates file descriptor 2 with the file currently associated with file 
descriptor 1. 


The order in which redirections are specified is significant. The shell 
evaluates redirections left-to-right. For example: 


ee 1 XXX 2>&1 


first associates file descriptor 1 with file xxx . It associates file 
descriptor 2 with the file associated with file descriptor 1 (i.e. xxx ). 
If the order of redirections were reversed, file descriptor 2 would be 
associated with the terminal (assuming file descriptor 1 had been) 
and file descriptor 1 would be associated with file xxx . 
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lf a command is followed by & the default standard input for the 
command is the empty file /dev/null . Otherwise, the environment 
for the execution of a command contains the file descriptors of the 
invoking shell as modified by input/output specifications. 


Redirection of output is not allowed in the restricted shell. 


Environment 


The environment (see environ (5)) is a list of name-value pairs that 
is passed to an executed program in the same way as a normal 
argument list. The shell interacts with the environment in several 
ways. On invocation, the shell scans the environment and creates a 
parameter for each name found, giving it the corresponding value. 
If the user modifies the value of any of these parameters or creates 
new parameters, none of these affects the environment unless the 
export command is used to bind the shell’s parameter to the 
environment (see also set -a ). A parameter may be removed from 
the environment with the unset command. The environment seen 
by any executed command is thus composed of any unmodified 
name-value pairs originally inherited by the shell, minus any pairs 
removed by unset , plus any modifications or additions, all of which 
must be noted in export commands. 


The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 


TERM=450 cmd and 
(export TERM; TERM=450; cmd) 


are equivalent (as far as the execution of cmd is concerned). 


lf the -k flag is set, a/f keyword arguments are placed in the 
environment, even if they occur after the command name. The fol- 
lowing first prints a=b c andc: 


echo a=bc 
set —k 
echo a=bc 


Signals 


The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by & ; otherwise signals have 
the values inherited by the shell from its parent, with the exception 
of signal 11 (but see also the trap command below). 


Execution 
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Each time a command is executed, the above substitutions are car- 
ried out. If the command name matches one of the Special Com- 
mands listed below, it is executed in the shell process. If the com- 
mand name does not match a Special Command , but matches the 
name of a defined function, the function is executed in the shell pro- 
cess (note how this differs from the execution of shell procedures). 
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The positional parameters $1, $2, .... are set to the arguments of 
the function. If the command name matches neither a Special 
Command nor the name of a defined function, a new process is 
created and an attempt is made to execute the command via exec 
(2). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin , and /usr/bin , in that order). Note that the 
current directory is specified by a null path name, which can appear 
immediately after the equal sign or between the colon delimiters 
anywhere else in the path list. If the command name contains a / 
the search path is not used; such commands will not be executed 
by the restricted shell. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission 
but is not an a.out file, it is assumed to be a file containing shell 
commands. A sub-shell is spawned to read it. A parenthesized 
command is also executed in a sub-shell. 


The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). 
lf the command was found in a relative directory, its location must 
be re-determined whenever the current directory changes. The 
shell forgets all remembered locations whenever the PATH variable 
is changed or the hash -r command is executed (see below). 


If you invoke a shell whose exit status you assign to a local variable 
and the shell you invoke runs a process in background, the invoked 
shell will not return until the background process has completed 


Special Commands 


Input/output redirection is now permitted for these commands. File 
descriptor 1 is the default output location. 


No effect; the command does nothing. A zero exit code is 
returned. 

. file Read and execute commands from file and return. The 
search path specified by PATH is used to find the directory 
containing file . 

break [nn | 
Exit from the enclosing for or while loop, if any. If n is 
specified break n levels. 

continue [ 7 | 
Resume the next iteration of the enclosing for or while 
loop. If n is specified resume at the n -th enclosing loop. 

cd[ arg | 
Change the current directory to arg . The shell parameter 
HOME is the default arg . The shell parameter CDPATH 
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defines the search path for the directory containing arg . 
Alternative directory names are separated by a colon (:). 
The default path is <null> (specifying the current direc- 
tory). Note that the current directory is specified by a null 
path name, which can appear immediately after the equal 
sign or between the colon delimiters anywhere else in the 
path list. If arg begins with a / the search path is not used. 
Otherwise, each directory in the path is searched for arg . 
The cd command may not be executed by rsh. 
echo[ arg... |] 
Echo arguments. See echo (7) for usage and description. 
eval [ arg... | 
The arguments are read as input to the shell and the result- 
ing command(s) executed. 
exec[ arg... | 
The command specified by the arguments is executed in 
place of this shell without creating a new _ process. 
Input/output arguments may appear and, if no other argu- 
ments are given, cause the shell input/output to be modi- 
fied. 
exit [ n ] 
Causes a shell to exit with the exit status specified by n. If 
n is omitted the exit status is that of the last command exe- 
cuted (an end-of-file will also cause the shell to exit.) 
export [ name... | 
The given name s are marked for automatic export to the 
environment of subsequently-executed commands. If no 
arguments are given, a list of all names that are exported in 
this shell is printed. Function names may not be exported. 
hash[ -r ][ name... |] 
For each name , the location in the search path of the com- 
mand specified by name is determined and remembered by 
the shell. The -r option causes the shell to forget all 
remembered locations. If no arguments are given, informa- 
tion about remembered commands is presented. Hits is the 
number of times a command has been invoked by the shell 
process. Cost is a measure of the work required to locate a 
command in the search path. There are certain situations 
which require that the stored location of a command be 
recalculated. Commands for which this will be done are 
indicated by an asterisk (*) adjacent to the hits information. 
Cost will be incremented when the recalculation is done. 
newgrp[ arg... | 
Equivalent to exec newgrp arg .... See newgrp (1) for 
usage and description. 
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pwd = Print the current working directory. See pwd (1) for usage 
and description. 

read[ name... | 
One line is read from the standard input and the first word is 
assigned to the first name , the second word to the second 
name , etc., with leftover words assigned to the last name . 
The return code is 0 unless an end-of-file is encountered. 

readonly [ name... | 
The given name s are marked readonly and the values of 
the these name s may not be changed by subsequent 
assignment. If no arguments are given, a list of all readonly 
names is printed. 

return [ n | 
Causes a function to exit with the return value specified by 
n. lf n is omitted, the return status is that of the last com- 
mand executed. 

set [ —aefhkntuvx [ arg ... | ] 


~a Mark variables which are modified or created for 
export. 

—e Exit immediately if a command exits with a non-zero 
exit status. 

—f Disable file name generation 

—h Locate and remember function commands as func- 


tions are defined (function commands are normally 
located when the function is executed). 

—k All keyword arguments are placed in the environ- 
ment for a command, not just those that precede 
the command name. 


—n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

—X Print commands and their arguments as they are 
executed. 

— Do not change any of the flags; useful in setting $1 
to-. 


Using + rather than — causes these flags to be turned off. 
These flags can also be used upon invocation of the shell. 
The current set of flags may be found in $— . The remaining 
arguments are positional parameters and are assigned, in 


order, to $1, $2, .... If no arguments are given the values 
of all names are printed. 

shift [ 7 |] 4 
The positional parameters from $n+1... are renamed $1 | | 


. If 7 is not given, it is assumed to be 1. ae 
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test 
fis Evaluate conditional expressions. See test (7) for usage 
( and description. 
i times 
Print the accumulated user and system times for processes 
run from the shell. 
trap | arg j[n]... 
The command arg is to be read and executed when the 
shell receives signal(s) n . (Note that arg is scanned once 
when the trap is set and once when the trap is taken.) Trap 
commands are executed in order of signal number. Any 
attempt to set a trap on a signal that was ignored on entry 
to the current shell is ineffective. An attempt to trap on sig- 
nal 11 (memory fault) produces an error. If arg is absent all 
trap(s) n are reset to their original values. if arg is the null 
string this signal is ignored by the shell and by the com- 
mands it invokes. If n is 0 the command arg is executed on 
exit from the shell. The trap command with no arguments 
prints a list of commands associated with each signal 
number. 
type [ name... | 
| For each name , indicate how it would be interpreted if used 
hile as a command name. 
( ulimit [ -fp ][ on ] 
: imposes a size limit of n 
—f imposes a size limit of n blocks on files written by 
child processes (files of any size may be read). 
With no argument, the current limit is printed. 
If no option is given, -f is assumed. 
umask [ nnn | 
The user file-creation mask is set to nnn (see umask (2)). If 
nnn is omitted, the current value of the mask is printed. 
unset [ name... | 
For each name , remove the corresponding variable or func- 
tion. The variables PATH, PS1, PS2, MAILCHECK and IFS 
cannot be unset. 
wait [7 | 
Wait for the specified process and report its termination 
status. If nm is not given ail currently active child processes 
are waited for and the return code is zero. 


Invocation 
If the shell is invoked through exec (2) and the first character of 
a argument zero is — , commands are initially read from /etc/profile 
( and from $HOME/.profile , if such files exist. Thereafter, commands 
= are read as described below, which is also the case when the shell 
is invoked as /bin/sh . The flags below are interpreted by the shell 
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on invocation only; Note that unless the —c or —s flag is specified, 
the first argument is assumed to be the name of a file containing 
commands, and the remaining arguments are passed as positional 
parameters to that command file: 


—c string If the —c flag is present commands are read from string . 

-S lf the —s flag is present or if no arguments remain com- 
mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell out- 
put (except for Special Commands ) is written to file 
descriptor 2. 

—i If the ~i flag is present or if the shell input and output are 
attached to a terminal, this shell is interactive . In this 
case TERMINATE is ignored (so that kill 0 does not kill 
an interactive shell) and INTERRUPT is caught and 
ignored (so that wait is interruptible). in all cases, QUIT 
is ignored by the shell. 

-r If the —-r flag is present the shell is a restricted shell. 


The remaining flags and arguments are described under the set 
command above. 


Rsh Only 


Rsh is used to set up login names and execution environments 
whose capabilities are more controlled than those of the standard 
shell. The actions of rsh are identical to those of sh , except that 
the following are disallowed: 

changing directory (see cd (7)), 

setting the value of $PATH, 

specifying path or command names containing / , 

redirecting output (> and >> ). 


The restrictions above are enforced after .profile is interpreted. 


When a command to be executed is found to be a shell procedure, 
rsh invokes sh to execute it. Thus, it is possible to provide to the 
end-user shell procedures that have access to the full power of the 
standard shell, while imposing a limited menu of commands; this 
scheme assumes that the end-user does not have write and exe- 
cute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has 
complete control over user actions, by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably 
not the login directory). 


The system administrator often sets up a directory of commands 


(i.e., /usr/rbin ) that can be safely invoked by rsh . Some systems ~ ~ 


also provide a restricted editor red . 
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EXIT STATUS 


FILES 


Errors detected by the shell, such as syntax errors, cause the shell 
to return a non-zero exit status. If the shell is being used non- 
interactively execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed (see also 
the exit command above). 


/etc/profile 
$HOME/.profile 
/tmp/sh« 
/dev/null 


SEE ALSO 


acctcom(1), cd(1), echo(1), env(1), login(1), newgrp(1), pwd(1), 
test(1), umask(1). 

acctcms(1M) in the Sys5 UNIX Administrator Reference Manual. 
dup(2), exec(2), fork(2), pipe(2), signal(2), ulimit(2), umask(2), 
wait(2), a.out(4), profile(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 


CAVEATS 


lf a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory where 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 


lf you move the current directory or one above it, pwd may not give 
the correct response. Use the cd command with a full path name to 
correct this situation. 
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NAME 
size — print section sizes of common object files 


SYNOPSIS 
size [—-o] [-x] [-V] files 


DESCRIPTION 
The size command produces section size information for each sec- 
tion in the common object files. The size of the text, data and bss 
(uninitialized data) sections are printed along with the total size of 
the object file. If an archive file is input to the size command the 
information for all archive members is displayed. 


Numbers will be printed in decimal unless either the —o or the —x 
option is used, in which case they will be printed in octal or in hexa- 
decimal, respectively. . 
The —V flag will supply the version information on the size com- 
mand. 
SEE ALSO 
as(1), cc(1), Id(1). 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 
DIAGNOSTICS | 


size: name: cannot open 
if name cannot be read. 


size: name: bad magic 
if name is not an appropriate common object file. 
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NAME 

sleep — suspend execution for an interval 
SYNOPSIS 

sleep time 


DESCRIPTION 
Sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time, as in: 


(sleep 105; command)& 
or to execute a command every so often, as in: 


while true 
do 
command 
Sleep 37 
done 


SEE ALSO 
alarm(2), sleep(SC) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 
sno — SNOBOL interpreter 
SYNOPSIS 
sno [| files ] 
DESCRIPTION 


Sno is a SNOBOL compiler and interpreter (with slight differences). 
Sno obtains input from the concatenation of the named file s and 
the standard input. All input through a statement containing the 
label end is considered program and is compiled. The rest is avail- 
able to syspit . 


Sno differs from SNOBOL in the following ways: 
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There are no unanchored searches. To get the same 
effect: 


aks b unanchored search for b. 
a *x* b = X C — unanchored assignment 


There is no back referencing. 


xX — "abc" 
Qa *X* X is an unanchored search for abc 


Function declaration is done at compile time by the use of 
the (non-unique) label define . Execution of a function call 
begins at the statement following the define . Functions 
cannot be defined at run time, and the use of the name 
define is preempted. There is no provision for automatic 
variables other than parameters. Examples: 


define f( ) 

define f(a, b, c) 
All labels except define (even end ) must have a non-empty 
statement. 


Labels, functions and variables must all have distinct 
names. In particular, the non-empty statement on end can- 
not merely name a label. 


lf start is a label in the program, program execution will 
start there. If not, execution begins with the first executable 
statement; define is not an executable statement. 


There are no built-in functions. 


Parentheses for arithmetic are not needed. Normal pre- 


cedence applies. Because of this, the arithmetic operators / fi 


and * must be set off by spaces. 
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The right side of assignments must be non-empty. 
Either ’ or “ may be used for literal quotes. 
The pseudo-variable sysppt is not available. 


SEE ALSO 
awk(1). 
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NAME 
sort — sort and/or merge files 


SYNOPSIS 
sort [-—cmu] [-—ooutput] [-ykmem] [-zrecsz] [-—dfiMnr] [—btx] 
[+pos1 [-—pos2]] [files] 


DESCRIPTION 
Sort sorts lines of all the named files together and writes the result 
on the standard output. The standard input is read if — is used as a 
file name or no input files are named. 


Comparisons are based on one or more sort keys extracted from 
each line of input. By default, there is one sort key, the entire input 
line, and ordering is lexicographic by bytes in machine collating 
sequence. 


The following options alter the default behavior: 


-~c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. | 


—m Merge only, the input files are already sorted. 


—u Unique: suppress all but one in each set of lines having equal 
keys. | 


—ooutput 
The argument given is the name of an output file to use 
instead of the standard output. This file may be the same as 
one of the inputs. There may be optional blanks between —o 
and output. 


—-ykmem 

The amount of main memory used by the sort has a large 
impact on its performance. Sorting a small file in a large 
amount of memory !s a waste. If this option is omitted, sort 
begins using a system default memory size, and continues to 
use more space as needed. If this option is presented with a 
value, kmem , sort will start using that number of kilobytes of 
memory, unless the administrative minimum or maximum is 
violated, in which case the corresponding extremum will be 
used. Thus, -y 0 is guaranteed to start with minimum 
memory. By convention, -—y (with no argument) starts with 
maximum memory. 


—ZreCSZ 
The size of the longest line read is recorded in the sort phase 
so buffers can be allocated during the merge phase. If the 
sort phase is omitted via the -c or —m options, a popular 
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system default size will be used. Lines longer than the buffer 
size will cause sort to terminate abnormally. Supplying the 
actual number of bytes in the longest line to be merged (or 
some larger value) will prevent abnormal termination. 


The following options override the default ordering rules. 


-d “Dictionary” order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. 


—f Fold lower case letters into upper case. 


-i ignore characters outside the ASCII range 040-0176 in non- 
numeric comparisons. 


—-M Compare as months. The first three non-blank characters of 
the field are folded to upper case and compared so that “JAN” 
< “FEB” <... < “DEC”. Invalid fields compare low to “JAN”. 
The —M option implies the —b option (see below). 


—n_ An initial numeric string, consisting of optional blanks, optional 
minus sign, and zero or more digits with optional decimal 
point, is sorted by arithmetic value. The —n option implies the 
—b option (see below). Note that the —b option is only effec- 
tive when restricted sort key specifications are in effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key specifica- 
tions, the requested ordering rules are applied globally to all sort 
keys. When attached to a specific sort key (described below), the 
specified ordering options override all global ordering options for that 
Key. 


The notation + pos? —pos2 restricts a sort key to one beginning at 
pos? and ending at pos2 . The characters at positions pos? and 
pos2 are included in the sort key (provided that pos2 does not pre- 
cede pos7 ). A missing —pos2 means the end of the line. 


Specifying pos? and pos2 involves the notion of a field, a minimal 
sequence of characters followed by a field separator or a new-line. 
By default, the first blank (space or tab) of a sequence of blanks 
acts as the field separator. All blanks in a sequence of blanks are 
considered to be part of the next field; for example, all blanks at the 
beginning of a line are considered to be part of the first field. The 
treatment of field separators can be altered using the options: 


-—tx Use x as the field separator character; x is not considered to 
be part of a field (although it may be included in a sort key). 
Each occurrence of x is significant (e.g., xx delimits an empty 
field). 
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-b Ignore leading blanks when determining the starting and end- 
ing positions of a restricted sort key. If the —b option is speci- 
fied before the first +pos7? argument, it will be applied to all 
+ pos? arguments. Otherwise, the b flag may be attached 
independently to each + posi? or —pos2 argument (see below). 


Pos? and pos2 each have the form m.n optionally followed by one 
or more of the flags bdfinr . A starting position specified by +m.n is 
interpreted to mean the n + 7st character in the m +1st field. A 
missing .. means . Q, indicating the first character of the m + 1st 
field. If the b flag is in effect n is counted from the first non-blank in 
the m + 1st field; +m.0b refers to the first non-blank character in 
the m + 1st field. 


A last position specified by -—m.n is interpreted to mean the n th 
character (including separators) after the last character of the m th 
field. A missing .1 means . Q, indicating the last character of the m 
th field. If the b flag is in effect n is counted from the last leading 
blank in the m +1st field; -m.1b refers to the first non-blank in the 
m + 1st field. 


When there are multiple sort keys, later keys are compared only 
after all earlier keys compare equal. Lines that otherwise compare 
equal are ordered with all bytes significant. 


EXAMPLES 
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Sort the contents of infile with the second field as the sort key: 
sort + 1 —2 infile 


Sort, in reverse order, the contents of infile1 and infile2 , placing the 
output in outfile and using the first character of the second field as 
the sort key: 


sort —r —o outfile +1.0 —1.2 infile1 infile2 


Sort, in reverse order, the contents of infile? and infile2 using the 
first non-blank character of the second field as the sort key: 


sort —r +1.0b —1.1b infile1 infile2 


Print the password file (oasswd(4)) sorted by the numeric user ID 
(the third colon-separated field): 


sort -t: +2n —3 /etc/passwd 
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aie Print the lines of the already sorted file infile , suppressing 
( all but the first occurrence of lines having the same third 
field (the options -um with just one input file make the 
choice of a unique representative from a set of equal lines 
predictable): 
sort -um +2 —3 infile 
FILES 
/usritmp/stm??? 
SEE ALSO 
comm(1), join(1), uniq(1). 
DIAGNOSTICS 


Comments and exits with non-zero status for various trouble condi- 
tions (e.g., when input lines are too long), and for disorder 
discovered under the -c option. When the last line of an input file is 
missing a new-line character, sort appends one, prints a warning 
message, and continues. 


May 27, 1985 Page 4 


SPELL(1) UNIX Sys5 SPELL(1) 


NAME 


spell, hashmake, spellin, hashcheck — find spelling errors 


SYNOPSIS 


spell [ -v ][-b ][-x ][-I][-i][ + local_file | [ files ] 
/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 


/usr/lib/spell/hashcheck spelling_list 


DESCRIPTION 
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Spell collects words from the named files and looks them up in a 
spelling list. Words that neither occur among nor are derivable (by 
applying certain inflections, prefixes, andor suffixes: from words in 
the spelling list are printed on the standard output. if no files are 
named, words are collected from the standard input. 


Spell ignores most troff (1), tb! (7), and eqn (7) constructions. 


Under the -—v option, ail words not literally in the spelling list are 
printed, and plausible derivations from the words in the spelling list 
are indicated. 


Under the —b option, British spelling is checked. Besides preferring 
centre , colour , programme , Speciality , traveiled , etc., this option 
insists upon -ise in words like standardise , Fowler and the OED to 
the contrary notwithstanding. 


Under the —x option, every plausible stem is printed with = for each 
word. 


f 


By default, spell (like deroff (1)) follows chains of included files (.so 
and .nx troff (1) requests), unless the names of such included files 
begin with /usrMib . Under the -l option, spe// will follow the chains 
of all included files. Under the -i option, spe! will ignore all chains 
of inciuded files. 


Under the +/ocal_file option, words found in focal_file are removed 
from spell ‘s output. Local_file is the name of a user-provided file 
that contains a sorted list of words, one per line. With this option, 
the user can specify a set of words that are correct spellings (in 
addition to spell ’s own spelling list) for each job. 


The spelling list is based on many sources, and while more napha- 
zard than an ordinary dictionary, is also more effective with respect 
to proper names and popular technical words. Coverage of the spe- 
cialized vocabularies of biology, medicine, and chemistry is light. 


Pertinent auxiliary files may be specified by name arguments, indi- 
cated below with their default settings (see F/LES ). Copies of all 
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output are accumulated in the history file. The stop list filters out 
misspellings (e.g., thier=- thy—y+ier) that would otherwise pass. 


Three routines help maintain and check the hash lists used by spell 


hashmake Reads a list of words from the standard input and 
writes the corresponding nine-digit hash code on the 
standard output. 


spellin n Reads n hash codes from the standard input and 
writes a compressed spelling list on the standard out- 
put. Information about the hash coding is printed on 
standard error. 


hashcheck Reads a compressed spelling_list and recreates the 
nine-digit hash codes for all the words in it; it writes 
these codes on the standard output. 


EXAMPLES 
The following example creates the hashed spell list hlist and checks 
the result by comparing the two temporary files; they should be 
equal. 


| cat goodwds | /usrilib/spell/hashmake | sort -u >tmp1 
( cat tmp1 | /usr/lib/spell/spellin <cat tmp1 | we -Is >hlist 
| cat hlist | /usr/lib/spell/nashcheck >tmp2 
diff tmp1 tmp2 


FILES 
D_SPELL=/usr/lib/spell/hlisttab] © hashed spelling lists, American & 
British 
— §_SPELL=-usr/libsspell/hstop hashed stop list 
H SPELL=-usrlibsspell/spellhist history file 
/usrilib/spell/spellprog program 
SEE ALSO 
deroff(1), eqn(1), sed(1), sort(1), tbl(1), tee(1), troff(1). 
BUGS 


The spelling list’s coverage is uneven; new installations will probably 
wish to monitor the output for several months to gather local addi- 
tions; typically, these are kept in a separate local file that is added 
to the hashed spelling_list via speliin . 

The British spelling feature was done by an American. 
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NAME | 
spline — interpolate smooth curve “ 

SYNOPSIS Se: 
spline [ options | 

DESCRIPTION 


Spline takes pairs of numbers from the standard input as abscissas 
and ordinates of a function. It produces a similar set, which is 
approximately equally spaced and includes the input set, on the 
standard output. The cubic spline output (R. W. Hamming, “Numeri- 
cal Methods for Scientists and Engineers” , 2nd ed., pp. 349ff) has 
two continuous derivatives, and sufficiently many points to look 
smooth when plotted, for example by graph (1G). 


The following options are recognized, each as a separate argument: 


—a Supply abscissas automatically (they are missing from the 
input); spacing is given by the next argument, or is assumed 
to be 1 if next argument is not a number. 


—k The constant k used in the boundary value computation: 


Vg SV Vy WV a 3 
is set by the next argument (default k = 0). 


—n Space output points so that approximately n intervals occur 
between the lower and upper x limits (default n = 100). 


—p Make output periodic, i.e., match derivatives at ends. First 
and last input values should normally agree. 


—X Next 1 (or 2) arguments are lower (and upper) x limits. 
Normally, these limits are calculated from the data. 
Automatic abscissas start at lower limit (default 0). 


SEE ALSO 
graph(1G). 


DIAGNOSTICS 
When data is not strictly monotone in x , spline reproduces the 
input without interpolating extra points. 3 


BUGS 
A limit of 1,000 input points is enforced silently. 


ae oe 
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NAME 


split — split a file into pieces 


SYNOPSIS 


split [ -n ] [ file [ name ] ] 


DESCRIPTION 


Split reads file and writes it in n -line pieces (default 1000 lines) onto 
a set of output files. The name of the first output file is name with 
aa appended, and so on lexicographically, up to zz (a maximum of 
676 files). Name cannot be longer than 12 characters. If no output 
name is given, x is default. 


If no input file is given, or if — is given in its stead, then the standard 
input file is used. 


SEE ALSO 
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bfs(1), csplit(1). 
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NAME 

sroff — format text 
SYNOPSIS 

sroff [ options | [ files ] 
DESCRIPTION 

Sroff formats text contained in files (standard input by default) for 

printing on typewriter-like devices and line printers, including the 

XEROX 9700 printer. 

An argument consisting of a minus (-) is taken to be a file name 

corresponding to the standard input. The options, which may 

appear in any order, but must appear before the files, are: 

—Oolist Print only pages whose page numbers appear in the /ist 
of numbers and ranges, separated by commas. A range 
N-M means pages N through M; an initial -N means 
from the beginning to page N; and a final N— means from 
N to the end. 

—sN Stop every N pages. Sroff will halt after every N pages 
(default N=1) to allow paper loading or changing, and will 
resume upon receipt of a line-feed or new-line. 

—mname Prepend to the input files the macro file 

_ fusr/lib/smac/mname. (None available so far. Develop- 
ment of an MM-like macro package for sroff is in pro- 
gress.) 

—xfile Write any index information onto file. 

SEE ALSO 
col(1), pg(1). 
BUGS 
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%# is the name of a register that contains the number of lines used 
on a page in single-column mode, or the number of lines in a diver- 
sion. %# should work in multt-column mode, but what should it 
count? 
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NAME 
stat — statistical network useful with graphical commands 


SYNOPSIS 
node-name [options] [files] 


DESCRIPTION 
Stat is a collection of command level functions (nodes) that can be 
interconnected using sh (7) to form a statistical network. The nodes 
reside in /usr/bin/graf (see graphics (1G)). Data is passed through 
the network as sequences of numbers (vectors), where a number is 
of the form: | 


[sign](digits)(.digits)[e[sign]digits] 


evaluated in the usual way. Brackets and parentheses surround 
fields. All fields are optional, but at least one of the fields sur- 
rounded by parentheses must be present. Any character input to a 
node that is not part of a number is taken as a delimiter. 


Stat nodes are divided into four classes. 


Transformers, which map input vector elements into 
output vector elements; 

Summarizers, - which calculate statistics of a vector; 

Translators, which convert among formats; and 

Generators, which are sources of definable vectors. 


Below is a list of synopses for stat nodes. Most nodes accept 
options indicated by a leading minus (—). In general, an option is 
specified by a character followed by a value, such as c5. This is 
interpreted as c := 5 (c is assigned 5). The following keys are used 
to designate the expected type of the value: 


Cc characters, 

i integer, 

f floating point or integer, 
file file name, and 


string — string of characters, surrounded by quotes to include 
a Shell argument delimiter. 


Options without keys are flags. All nodes except generators accept 
files as input, hence it is not indicated in the synopses. 


Transformers : 


abs [-c/] — absolute value 
columns __ (similarly for -c options that follow) 
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af 


ceil 
cusum 
exp 
floor 
gamma 


list 


log 


mod 


pair 


power 


root 


round 


siline 


sin 
subset 


bucket 
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-—ci tv | — arithmetic function 
itled output, v erbose 


—c/ | — round up to next integer 


[ 

t 

{—c/] — cumulative sum 

[—c/ ] — exponential 
[—c/] — round down to next integer 
[-—c/] — gamma 

[ 


—ci dstring | — list vector elements 


d elimiter(s) 

[-ci bf |] — logarithm 
base 

[—ci mf ] — modulus 
modulus 


[-c/ Ffile x1] — pair elements 
File containing base vector, x group size 


{-c/ pf | — raise to a power 
power 


{-—c/ rf |] — take a root 
root 


[-c/ p/ si ] — round to nearest integer, .5 rounds to 
1 


p laces after decimal point, s ignificant digits 


[-c/ if nisf ] — generate a line given slope and inter- 
cept 

intercept, n umber of positive integers, s lope 
[—c/] — sine 

[-af bf ci Ffife iv If ni np pf si t/] — generate a sub- 
set 

above, below, File with master vector, interval, 


leave, master contains element numbers to master 
contains element numbers to pick, start, terminate 


[-a/ c/ Ffile hf if If ni] — break into buckets 

average size, File containing bucket boundaries, 
high, interval, low, number 

Input data should be sorted 
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cor 


hilo 


lreg 


mean 


point 


prod 
qsort 
rank 
total 


Var 


Translators : 


bar 


hist 


label 
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[ -Ffile | — correlation coefficient 
File containing base vector 


[— hl 0 ox oy |— find high and low values 

h igh only, | ow only, o ption form, o ption 
form with x prepended, o ption form with y 
prepended 


[-Ffile io s ] — linear regression 
F ile containing base vector, i ntercept only, o 
ption form for siline, slope only 


[-ff ni pf | — (trimmed) arithmetic mean 
fraction, number, percent 


[-ff ni pfs ] — point from empirical cumulative den- 
sity function 
fraction, number, percent, sorted input 


— internal product 
[-c/ ] — quick sort 
— vector rank 

— sum total 


— variance 


[-a bf g riwi xf xa yf ya ylf yhf | — build a bar 
chart 

Suppress axes, bold, suppress .}f rame, suppress 
grid, region, idth in percent, x origin, suppress jf 
xis label, y origin, suppress y xis label, y-axis lower 
bound, -axis high bound 

Data is rounded off to integers. 


[-a b f g ri xf xa yf ya ylf yhf |] — build a histo- 
gram 

suppress axes, bold, suppress .;f rame, suppress 
grid, region, origin, suppress x-axis label, y origin, 
suppress y xis label, y-axis lower bound, -axis high 
bound 


[-b c Ffile h p ri x xu y yr | — label the axis of a 
GPS file 

b ar chart input, retain c ase, label F ile, h isto- 
gram input, p lot input, r otation, x -axis, u 
pper x -axis, y -axis, right y -axis 
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[-—b 0 p pn ppl ri v x/ yi | — build a pie chart 
b old, values o utside pie, value as p ercen- 
tage(:= 100), value as p ercentage(:=i), draw p 
ercent of pie, region, no v alues, x origin, y 
origin 
Unlike other nodes, input is lines of the form 
[< ief cc >] value [label] 
i gnore (do not draw) slice, e xplode slice, 
f ill slice, c olor slice c =(b lack, red,g 
reen, bl u e) 


[-a b cstringd f Ffile xf xa xif xhf xif xn xt 
yf ya yif yn ylf yr yt | — plot a graph 

suppress axes, bold, plotting .;f haracters, discon- 
nected, suppress ile containing x vector, suppress 
grid, mark points, region, x Origin, Suppress x-axis 
label, x interval, x h igh bound, x low bound, 
number -axis, suppress x-axis title, y origin, 
suppress y-axis label, y interval, y h igh bound, y 
low bound, number -axis, suppress y-axis title 


[-—b c Istring vstring u | — title a vector or aGPS 
title bold, retain case, lower title, upper title, vector 


[-c/ if ni sf tf ] — generate additive sequence 
interval, number, start, terminate 


[-c/ hi li ni | — generate prime numbers 
high, low, number 


[-ci hf If mf ni si] — generate random sequence 
high, low, multiplier, number, seed 


Some nodes have a limit on the size of the input vector. 


STAT(1G) 
_ pie 
( 
plot 
title 
( Generators : 
- gas 
prime 
rand 
RESTRICTIONS 
SEE ALSO 
graphics(1G). 


gps(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 


strings — find the printable strings in a object, or other binary, file fre 
SYNOPSIS meee 


/usr/plx/strings [ - ] [ -o ] [ -number | file ... 


DESCRIPTION 

Strings looks for ASCII strings in a binary file. A string is any 
sequence of 4 or more printing characters ending with a newline or 
a null. Unless the — flag is given, strings only looks in the initialized 
data space of object files. If the -o flag is given, then each string Is 
preceded by its offset in the file (in octal). If the -number flag is 
given then number is used as the minimum string length rather than 
4. 


Strings is useful for identifying random object files and many other 
things. 


NOTES 
This command ts based on a similar one from the University of Cali- 
fornia at Berkeley. 


SFE ALSO 
od(1) 


BUGS 
The algorithm for identifying strings is extremely primitive. 


wen 
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NAME 


strip — strip symbol and line number information from a common 
object file 


SYNOPSIS 


strip [-I] [-x] [-r] [-V] filename 


DESCRIPTION 


FILES 


The strip command strips the symbol table and line number informa- 
tion from common object files, including archives. Once this has 
been done, no symbolic debugging access will be available for that 
file; therefore, this command is normally run only on production 
modules that have been debugged and tested. 


The amount of information stripped from the symbol table can be 
controlled by using any of the following options: 


—| Strip line number information only; do not strip any symbol 
table information. 


—X Do not strip static or external symbol information. 
-r Reset the relocation indexes into the symbol table. 
~-V Print the version of the strip command executing on the 


Standard error output. 


If there are any relocation entries in the object file and any symbol 
table information is to be stripped, strip will complain and terminate 
without stripping file-name unless the -r flag is used. 


If the strip command is executed on a common archive file (see ar 
(4)) the archive symbol table will be removed. The archive symbol 
table must be restored by executing the ar (7) command with the s 
option before the archive can be link-edited by the /d (7) command. 
Strip will instruct the user with appropriate warning messages when 
this situation arises. 


The purpose of this command its to reduce the file storage overhead 
taken by the object file. 


SEE ALSO 


ar(1), as(1), cc(1), Id(1). 
a.out(4), ar(4) in the Sys5 UNIX Programmer Reference Manual. 


DIAGNOSTICS 
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strip: name: cannot open 
if name cannot be read. 
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strip: name: bad magic 
if name is not an appropriate common 
object file. 


strip: name: relocation entries present; cannot strip 
if name contains relocation entries and 
the -r flag is not used, the symbol table informa- 
tion cannot be stripped. 
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NAME 


stty — set the options for a terminal 


SYNOPSIS 


stty [ -f <tty-device> | [ -a ] [ -g ] [ options ] 


DESCRIPTION 


Stty sets certain terminal /O options for the device that is the 
current standard input; without arguments, it reports the settings of 
certain options; with the —a option, it reports all of the option set- 
tings; with the —g option, it reports current settings in a form that 
can be used as an argument to another stty command. With the —f 
option, the current standard input is not used, but the specified 
tty_device is opened with NDELAY specified and the subsequent 
argument operations are applied to the specified tty-device. The —f 
option must be specified first (with its device name, separate from 
other options). Detailed information about the modes for asynchro- 
nous lines listed in the first five groups below may be found in tty(7) 
in the UNIX System Administrator Reference Manual. Options in 
the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, 
but no sanity checking is performed. The options are selected from 
the following: 


Control Modes 
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parenb (-parenb) enable (disable) parity generation and detec- 
tion. 
parodd (—parodd ) 
select odd (even) parity. 
cCS5 cs6 cs7 cs8 
select character size (see tty(7)). 
0 hang up phone line immediately. 
50 75 110 134 150 
200 300 600 1200 
1800 2400 4800 
9600 19200 exta extb 
Set terminal baud rate to the number given, if possible. (All 
speeds are not supported by all hardware interfaces.) 
hupcl (—hupcl ) 
hang up (do not hang up) DATA-PHONE® connection on last 
close. 
hup (—hup ) 
same as hupcl ( —hupcl ). 
cstopb ( —cstopb ) 
use two (one) stop bits per character. 
cread (—cread ) 
enable (disable) the receiver. 


October 7, 1986 


STTY(1) UNIX Sys5 STTY(1) 


clocal (—clocal ) 
assume a line without (with) modem control. PPR 

loblk ( —loblk ) | 
block (do not block) output from a non-current layer. Sa? 


Input Modes 
ignbrk (—ignbrk ) — ignore (do not ignore) break on input. 
brkint (—brkint ) 
signal (do not signal) INTR on break. 
ignpar (—ignpar ) 
ignore (do not ignore) parity errors. 
parmrk (—parmrk ) 
mark (do not mark) parity errors (see fty(7)). 
inpck (—inpck ) 
enable (disable) input parity checking. 
istrip (—istrip ) 
strip (do not strip) input characters to seven bits. 
inler (—-inlcr ) 
map (do not map) NL to CR on input. 
igncr (—-igncr ) 
ignore (do not ignore) CR on input. 
icrnl (—icrnl ) 
map (do not map) CR to NL on input. a 
iucic (-—iuclc ) a 
map (do not map) upper-case alphabetics to lower case on : 
input. 
ixon (-ixon ) 
enable (disable) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by sending an 
ASCII DC1. . 
ixany (-—ixany ) 
allow any character (only DC1) to restart output. 
ixoff ( —ixoff ) 
request that the system send (not send) START/STOP char- 
acters when the input queue is nearly empty/full. 
icts (-—icts ) 
Use the Clear To Send line to determine the status of the 
input queue as above. Clear To Send is on when high. 
ictslo ( -ictslo ) 
Same as icts except Clear To Send is on when low. 


Output Modes 
opost (—opost ) post-process output (do not post-process out- 
put; ignore all other output modes). ! , 
olcuc (-olcuc ) ee 
map (do not map) lower-case alphabetics to upper case on 
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output. 
onicr (-onlcr ) 

map (do not map) NL to CR-NL on output. 
ocrnl ( —ocrnl ) 

map (do not map) CR to NL on output. 
onocr ( —onocr ) 

do not (do) output CRs at column zero. 
onlret ( —onlret ) 

on the terminal NL performs (does not perform) the CR func- 

tion. 
ofill ( -ofill ) 

use fill characters (use timing) for delays. 
ofdel ( —ofdel ) 

fill characters are DELs (NULS). 
crO cri cr2 cr3 

select style of delay for carriage returns (see tty(7)). 
ni0 nl1 select style of delay for line-feeds (see fty(7)). 
tabO tab1 tab2 tab3 

select style of delay for horizontal tabs (see tty(7). 
bs0O bs1 

select style of delay for backspaces (see fty(7)). 
ff0 ff1 select style of delay for form-feeds (see fty(7)). 
vt0 vt1 select style of delay for vertical tabs (see fty(7)). 


Local Modes 
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isig (-isig) — enable (disable) the checking of characters 
against the special control characters INTR, 
QUIT, and SWTCH. 

icanon (-—icanon ) 
enable (disable) canonical input (ERASE and KILL process- 
ing). 

xcase ( -—xcase ) 
canonical (unprocessed) upper/lower-case presentation. 

echo (-echo ) 
echo back (do not echo back) every character typed. 

echoe (—echoe ) 
echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals; however, it 
does not keep track of column position and, as a result, 
may be confusing on escaped characters, tabs, and back- 
spaces. 

echok ( —echok ) 
echo (do not echo) NL after KILL character. 

Ifke (-Ifke ) 
the same as echok (—echok ); obsolete. 
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echon! (—echonl ) 
echo (do not echo) NL 
noflsh (—-nofish ) i 
disable (enable) flush after INTR, QUIT, or SWTCH. ee 
stwrap (—stwrap ) 
disable (enable) truncation of lines longer than 79 charac- 
ters on a synchronous line. 
Stflush (—-stflush ) 
enable (disable) flush on a synchronous line after every 
write (2). 
stappl (-—stappl ) 
use application mode (use line mode) on a synchronous 
line. 


Control Assignments 

control-character c set control-character to c , where control- 
Character is erase, kill, intr, quit, switch, 
eof, eol , ctab, min, or time (ctab is used 
with i —stappl; (min and time are used with 
—icanon; see fty(7)). If c is preceded by an 
(escaped from the shell) caret (“), then the 
value used is the corresponding CTRL charac- 
ter (e.g., ““d” is a CTRL-d); “"?" is interpreted =. 
as DEL and ‘“*—’” is interpreted as undefined. 

lines set line discipline to / (0 < i < 127). 


Combination Modes 
evenp or parity enable parenb 
and cs7. 
oddp_=_ enable parenb, cs7, and parodd. 
—parity, —evenp, or —oddp 
disable parenb, and set cs8. 
raw ( -raw or cooked) enable (disable) raw input and output (no 
ERASE, KILL, INTR, QUIT, SWTCH, EOT, or output post pro- 
cessing). 
ni ( —nl) 
unset (set) icrnl, onlcr. In addition —nl unsets inlcr, igner, 
ocrnl, and ontret. 
Icase ( —Icase) 
set (unset) xcase, iucic, and olcuc. 
LCASE ( -LCASE) 
same as Icase ( —Icase). 
tabs (-tabs or tab3 ) 
preserve (expand to spaces) tabs when printing. —_— 
ek reset ERASE and KILL characters back to normal # and @. \ Zp 
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sane __ resets all modes to some reasonable values. 
term set ail modes suitable for the terminal type ferm , where 
term is one of tty33, tty37, vt05, tn300, ti700, or tek. 


Miscellaneous 

flush Performs immediate flush of inout and output queues asso- 
ciated with terminal. Flush is useful when a process has 
been killed but will not terminate due to I/O Penang: 

iflush Empties input queue. See flush. 

oflush Empties output queue. See flush. 

SEE ALSO 

tabs(1). 

loctl(2) in the Sys5 UNIX Programmer's Reference Manual. 

tty(7) in the UNIX User’s Reference Manual. 
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NAME 


style — analyze surface characteristics of a document 


SYNOPSIS 


lusr/plx/style [ —ml ] [ -—mm ] [ -a ] [ -e ] [ -I num ] [ -r num 
]}{-—-p][-—P ] file ... 


DESCRIPTION 


Style analyzes the surface characteristics of the writing style of a 
document. It reports on readability, sentence length and structure, 
word length and usage, verb type, and sentence openers. Because 
style runs deroff before looking at the text, formatting header files 
should be included as part of the input. The default macro package 
-—ms may be overridden with the flag -mm. The flag —ml, which 
causes deroff to skip lists, should be used if the document contains 
many lists of non-sentences. The other options are used to locate 
sentences with certain characteristics. 


—a print all sentences with their length and readability index. 
—e print all sentences that begin with an expletive. 
—p print all sentences that contain a passive verb. 


-Inum_ print all sentences longer than num. 
-—rnum print all sentences whose readability index is greater than 


num. 
—P print parts of speech of the words in the document. 
SEE ALSO 
deroff(1) 
BUGS 
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Use of non-standard formatting macros may Cause incorrect sen- 
tence breaks. 
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Su — become super-user or another user 


SYNOPSIS 


su[-—][name[ arg... ] ] 


DESCRIPTION 


Su allows one to become another user without logging off. The 
default user name is root (i.e., Super-user). 


To use su, the appropriate password must be supplied (unless one 
is already root). If the password is correct, su will execute a new 
shell with the real and effective user ID set to that of the specified 
user. The new shell will be the optional program named in the shell 
field of the specified user's password file entry (see passwd (4)), or 
/bin/sh if none is specified (see sh (7)). To restore normal user ID 
privileges, type an EOF (cnitrl-d) to the new shell. 


Any additional arguments given on the command line are passed to 
the program invoked as the shell. When using programs like sh (7), 
an arg of the form —ce string executes string via the shell and an arg 
of -r will give the user a restricted shell. 


The following statements are true only if the optional program 
named in the shell field of the specified user's password file entry is 
like sh(1). If the first argument to su is a — , the environment will be 
changed to what would be expected if the user actually logged in as 
the specified user. This is done by invoking the program used as 
the shell with an argO value whose first character is — , thus causing 
first the system's profile (/etc/profile) and then the specified user's 
profile (.profile in the new HOME directory) to be executed. Other- 
wise, the environment is passed along with the possible exception of 
S$PATH , which is set to /bin:/etc:/usr/bin for root . Note that if the 
optional program used as the shell is /bin/sh , the user's .profile 
can check argO for —sh or —su to determine if it was invoked by 
login(1) or su(1), respectively. If the user's program is other than 
/bin/sh, then .profile is invoked with an argO of -program by both 
login(1) and su(1). 7 


All attempts to become another user using su are logged in the log 
file /usr/adm/sulog . 


EXAMPLES 
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To become user bin while retaining your previously exported 
environment, execute: 


su bin 


To become user bin but change the environment to what would be 
expected if bin had originally logged in, execute: 
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su - bin 


To execute command with the temporary environment and permis- 
sions of user bin, type: 


su - bin -c "command args” 


FILES 
/etc/passwd system's password file 
/etc/profile system's profile 
$HOME/.profile user's profile 
/usr/adm/sulog log file 

SEE ALSO 


env(1), login(1), sh(1). 
passwd(4), profile(4), environ(5) in the Sys5 UNIX Programmer 
Reference Manual. 
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NAME 
sum — print checksum and block count of a file 


SYNOPSIS 
sum [ -r | file 

DESCRIPTION 
Sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of blocks in the file. It is typically used to 
look for bad spots, or to validate a file communicated over some 
transmission line. The option —r causes an alternate algorithm to be 
used in computing the checksum. 


SEE ALSO 
wc(1). 


DIAGNOSTICS 
“Read error” is indistinguishable from end of file on most devices; 
check the block count. 
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NAME 
sync — update the super block 


SYNOPSIS 
sync 

DESCRIPTION | 
Sync executes the sync system primitive. If the system is to be 
stopped, sync must be called to insure file system integrity. It will 
flush all previously unwritten system buffers out to disk, thus assur- 
ing that all file modifications up to that point will be saved. See sync 
(2) for details. 


SEE ALSO 
sync(2) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 

tabs — set tabs on a terminal 
SYNOPSIS 

tabs [ tabspec ] [ +m n ] [ —T type ] 
DESCRIPTION 
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Tabs sets the tab stops on the user's terminal according to the tab 
specification tabspec , after clearing any previous settings. The 
user’s terminal must have remotely-settable hardware tabs. 


Users of GE TermiNet terminals should be aware that they behave 
in a different way than most other terminals for some tab settings. 
The first number in a list of tab settings becomes the /eft margin on 
a TermiNet terminal. Thus, any list of tab numbers whose first ele- 
ment is other than 1 causes a margin to be left on a TermiNet, but 
not on other terminals. A tab list beginning with 1 causes the same 
effect regardless of terminal type. It is possible to set a left margin 
on some other terminals, although in a different way (see below). 


Four types of tab specification are accepted for tabspec : “canned,” 
repetitive, arbitrary, and file. If no tabspec is given, the default 
value is —8 , l.e., UNIX system “standard” tabs. The lowest column 
number is 1. Note that for tabs , column 1 always refers to the left- 
most column on a terminal, even one whose column markers begin 
at 0, e.g., the DAS! 300, DAS! 300s, and DAS! 450. 


—code Gives the name of one of a set of “canned” tabs. The 
legal codes and their meanings are as follows: 

—a 1,10,16,36, 72 
Assembler, IBM S/370, first format 

—a2 1,10,16,40, 72 
Assembler, IBM S/370, second format 

—C 1,8,12,16,20,55 
COBOL, normal format 

—c2 1,6,10,14,49 
COBOL compact format (columns 1-6 omitted). Using this 
code, the first typed character corresponds to card column 
7, one space gets you to column 8, and a tab reaches 
column 12. Files using this tab setup should include a for- 
mat specification as follows: 

<:t-c2 m6 s66 d:> 

—C3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 
COBOL compact format (columns 1-6 omitted), with more 
tabs than —c2. This is the recommended format for COBOL. 
The appropriate format specification is: 

<:t-c3 m6 s66 d:> 

—f 1,7,11,15,19,23 

FORTRAN 
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—p 1,5,9,13,17,21,25,29,33,37,41 ,45,49,53,57,61 
PLA 

—S 1,10,55 
SNOBOL 

—U 1,12,20,44 


UNIVAC 1100 Assembler 
In addition to these “canned” formats, three other types exist: 


=n A repetitive specification requests tabs at columns 1+n, 
1+2x*n, etc. Note that such a setting leaves a left margin 
of nm columns on TermiNet terminals only . Of particular 
importance is the value —8 : this represents the UNIX sys- 
tem “standard” tab setting, and is the most likely tab set- 
ting to be found at a terminal. It is required for use with the 
nrotf —h option for high-speed output. Another special 
case is the value —0 , implying no tabs at ail. 

ni ,n2,... 
The arbitrary format permits the user to type any chosen 
set of numbers, separated by commas, in ascending order. 
Up to 40 numbers are allowed. If any number (except the 
first one) is preceded by a plus sign, it is taken as an incre- 
ment to be added to the previous value. Thus, the tab lists 
1,10,20,30 and 1,10,+10,+10 are considered identical. 

—file —\f the name of a file is given, tabs reads the first line of the 
file, searching for a format specification. If it finds one 
there, it sets the tab stops according to it, otherwise it sets 
them as -8 . This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set- 
tings, and would be used with the pr (7) command: 

tabs — file; pr file 


Any of the following may be used also; if a given flag occurs more 
than once, the last value given takes effect: 


-Ttype Tabs usually needs to know the type of terminal in order to 
set tabs and always needs to know the type to set mar- 
gins. Type is a name listed in term (5). If no -T flag is 
supplied, tabs searches for the $TERM value in the 
environment (see environ (5)). If no type can be found, 
tabs tries a sequence that will work for many terminals. 

+mn The margin argument can be used for some terminals. It 
Causes all tabs to be moved n columns by making column 
n+7 the left margin. If +m is given without a value of n, 
the value assumed is 10. For a TermiNet, the first value in 
the tab list must be 1, or the margin will move further to the 
right. The normal (leftmost) margin on most terminals is 
obtained by +m0 . The margin for most terminals is reset 
only when the +m flag is given explicitly. 
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Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 


illegal tabs when arbitrary tabs are ordered incorrectly. 

illegal increment when a zero or missing increment is found in 
an arbitrary specification. 

unknown tab code when a “canned” code cannot be found. 

can't open if —file option used, and file cant be opened. 

file indirection if —file option used and the specification in 
that file points to yet another file. Indirection 
of this form is not permitted. 


SEE ALSO 


BUGS 
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pr(1). 
environ(5), term(5) in the Sys5 UNIX Programmer Reference 
Manual. 


There is no consistency among different terminals regarding ways of 
clearing tabs and setting the left margin. 

It is generally impossible to usefully change the left margin without 
also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), 
but is willing to set 64. 
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NAME 


tail — deliver the last part of a file 


SYNOPSIS 


tail [ + [number][ lbc [ f ] ] ] [ file ] 


DESCRIPTION 


Tail copies the named file to the standard output beginning at a 
designated place. If no file is named, the standard input is used. 


Copying begins at distance +number from the beginning, or 
—number from the end of the input (if number is null, the value 10 is 
assumed). Number is counted in units of lines, blocks, or characters, 
according to the appended option 1, b , orc. When no units are 
specified, counting is by lines. 


With the —f (‘‘follow’’) option, if the input file is not a pipe, the pro- 
gram will not terminate after the line of the input file has been copied, 
but will enter an endless loop, wherein it sleeps for a second and 
then attempts to read and copy further records from the input file. 
Thus it may be used to monitor the growth of a file that is being writ- 
ten by some other process. For example, the command: 


tail -—f fred 


will print the last ten lines of the file fred , followed by any lines that 
are appended to fred between the time ta// is initiated and killed. As 
another example, the command: 


tail -—15cf fred 


will print the last 15 characters of the file fred , followed by any lines 
that are appended to fred between the time ta// is initiated and 
killed. 


SEE ALSO 


BUGS 
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dd(1). 


Tails relative to the end of the file are treasured up in a buffer, and 
thus are limited in length. Various kinds of anomalous behavior may 
happen with character special files. 
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NAME 
tape - tape manipulation 
SYNOPSIS 
tape [ -9ctf [filename] ] [command [options] ] 
DESCRIPTION 
Tape executes special commands on 9-track and cartridge tapes. 
Tape accesses the filename given via the -f switch. If none is given, 
the program opens the tape filename, /dev/rrm/Omn. lf that fails, it 
opens /dev/rpt/Omn. The tape file it eventually accesses must be a 
character special file. 
Tape figures out the type of tape (9-track or cartridge) unless the ’c’ 
or ’9’ switches are given. 
The available switches are: 
Cc The tape file is on a cartridge tape. Tape does not try 
figure Out the type of tape if this is given. 
9 The tape file is on a 9-track tape. Tape does not try 
figure out the type of tape if this is given. 
t Print the type of tape. 
f filename Do the special command on the tape file filename. 
Filename must be a character special file. 
Tape accepts a command after the switches. If none is given, it 
assumes the command status for the 9-track and srcheof O for the 
cartridge. 
These are the acceptable commands and their options for a 9-track 
tape: 
erase n Erases a fixed length (approximately 3.5 inches) for 
each value of n from the current position. 
eraseall Erase tape from current position to beyond the end of 
tape. 
status Report the status returned by tape controller. 
rforeign Reports the status and block size in bytes of file on 
tape. Leaves the tape in the middle of the file. 
unload Unloads the tape. 
space n Space forward n data blocks. 
spaceeof n Space forward n data blocks. Terminates early if it 
encounters an end-of-file on tape. 
srcheof n Position tape to the n-th end-of-file mark from the 
current position. If n is omitted, 1 is assumed. n should 
be a positive integer. If filename is given with the f 
switch you should specify a tape filename with no 
rewind, e.g., /dev/rrm/Omn. 
rew Rewinds the tape to the load point. 
weof Write an end-of-file on tape at current position. 
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These are the acceptable commands and their options for a cartridge 


tape: | 
rew Rewinds the cartridge to the load point. 
weof Write an end-of-file on cartridge at Current position. This 
is dangerous because it could overwrite data anywhere 
on the cartridge. Don’t use it if you want the data on 
the cartridge. 
srcheof n Position to the n-th file on the cartridge. Positioning is 
always done from the beginning of the cartridge. If n is 
omitted, 1 is assumed. n should be a positive integer. 
If filename is given with the f switch you should specify 
a tape filename with no rewind, e.g., /dev/rrm/Omn. 
eraseall Erase cartridge. The abbreviation ‘erase’ works also. 
retension Retension the cartridge. This should be done with new 
cartridges, cartridges that have been unused for some 
time, or cartridges that produce a hard error when 
accessing. The abbreviation ‘ret’ works also. See the 
Plexus Cartridge Tape Drive Manual (Plexus Publication 
Number 98-05016.3) for more information. 
FILES 
/dev/rrm/Omn 
/dev/rpt/Omn 
SEE ALSO 
pt(7), rm(7). 
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NAME 


tar — tape file archiver 


SYNOPSIS 


tar [ key ] [ files ] 


DESCRIPTION 
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Tar saves and restores files on magnetic tape. Its actions are con- 
trolled by the key argument. The key is a string of characters con- 
taining at most one function letter and possibly one or more function 
modifiers. Other arguments to the command are files (or directory 
names) specifying which files are to be dumped or restored. In all 
cases, appearance of a directory name refers to the files and (recur- 
Sively) subdirectories of that directory. 


The function portion of the key is specified by one of the following 
letters: 


r The named files are written on the end of the tape. Thec 
function implies this function. 


4 The named files are extracted from the tape. If a named file 
matches a directory whose contents had been written onto 
the tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no 
files argument is given, the entire content of the tape is 
extracted. Note that if several files with the same name are 
on the tape, the last one overwrites all earlier ones. 


t The names of the specified files are listed each time that they 
occur on the tape. If no files argument is given, all the 
names on the tape are listed. 


u The named files are added to the tape if they are not already 
there, or have been modified since last written on that tape. 


c Create a new tape; writing begins at the beginning of the 
tape, instead of after the last file. This command implies the 
r function. 


The following characters may be used in addition to the letter that 
selects the desired function: 


0,...,/7 This modifier selects the drive on which the tape is mounted. 
The default is 0. 


Vv Normally, tar does its work silently. The v (verbose) option 
causes it to type the name of each file it treats, preceded by 
the function letter. With the t function, v gives more informa- 
tion about the tape entries than just the name. 


w Causes tar to print the action to be taken, followed by the 


name of the file, and then wait for the user’s confirmation. lf / 
a word beginning with y is given, the action is performed. 


Any other input means “‘no’’. 
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FILES 


f Causes tar to use the next argument as the name of the 
archive instead of /dev/rrm/Om. lf the name of the file is —, 
tar writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as 
the head or tail of a pipeline. Tar can also be used to move 
hierarchies with the command: 


(6d: Tromdir; tar-ct =.) (ed todirs tar xf =) 


b Causes tar to use the next argument as the blocking factor 
for tape records. The default is 1, the maximum is 20. The 
block size is determined automatically when reading tapes 
(key letters x and t). Specifying the wrong block size with the 
b option can lead to unpredictable results. 


l Tells tar to complain if it cannot resolve all of the links to the 
files being dumped. If l is not specified, no error messages 
are printed. 


m Tells tar to not restore the modification times. The 
modification time of the file will be the time of extraction. 


/dev/rpt/Om = (cartridge tape - rewind) 
/dev/rpt/Omn (cartridge tape - no rewind) 
/dev/rrm/Om_ = (9-track tape - rewind) 
/dev/rrm/Omn (9-track tape - no rewind) 
/tmp/tars 


DIAGNOSTICS 


BUGS 


Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 


There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be 
updated. The current magnetic tape driver cannot backspace raw 
magnetic tape. If the archive is on a disk file, the b option shouid not 
be used at all, because updating an archive stored on disk can des- 
troy it. 

The current limit on file-name length is 100 characters. 

The rand u options do not work. 

Tar does not preserve the access modes and aHerSniS of direc- 
tories. If you need them preserved, use cpio(1) instead. See also 
find(1). | 
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tbl — format tables for nroff or troff 


SYNOPSIS 


tbl [ -TX ] [ files ] 


DESCRIPTION 
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Tbi is a preprocessor that formats tables for nroff or troff(1). The 
input files are copied to the standard output, except for lines 
between .TS and .TE command lines, which are assumed to 
describe tables and are re-formatted by tb/. (The .TS and .TE com- 
mand lines are not altered by fb/). 


.TS is followed by global options. The available global options are: 


center center the table (default is left-adjust); 

expand make the table as wide as the current line 
length; 

box enclose the table in a box; 

doublebox 
enclose the table in a double box: 

allbox enclose each item of the table in a box; 

tab (x) use the character x instead of a tab to separate 
items in a line of input data. 


The global options, if any, are terminated with a semi-colon (;). 


Next come lines describing the format of each line of the table. 
Each such format line describes one line of the actual table, except 
that the last format line (which must end with a period) describes al/ 
remaining lines of the table. Each column of each line of the table 
is described by a single key-letter, optionally followed by specifiers 
that determine the font and point size of the corresponding item, 
that indicate where vertical bars are to appear between columns, 
that determine column width, inter-column spacing, etc. The avail- 
able key-letters are: 


Cc center item within the column; 

r right-adjust item within the column; 

left-adjust item within the column; 

n numerically adjust item in the column: units posi- 
tions of numbers are aligned vertically; 

Ss span previous item on the left into this column; 

a center longest line in this column and then left- 


adjust all other lines in this column with respect to 
that centered line; 

span down previous entry in this column; 

replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 
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The characters B and | stand for the bold and italic fonts, respec- 
tively; the character | indicates a vertical line between columns. 


The format lines are followed by lines containing the actual data for 
the table, followed finally by .TE Within such data lines, data items 
are normally separated by tab characters. 


lf a data line consists of only _ or ~, a single or double line, respec- 
tively, is drawn across the table at that point; if a single item ina 
data line consists of only _ or =, then that item is replaced by a sin- 
gle or double line. 


Full details of all these and other features of fb/ are given in the 
reference manual cited below. | 


The —TX option forces ftb/ to use only full vertical line motions, mak- 
ing the output more suitable for devices that cannot generate partial 
vertical line motions (e.g., line printers). 


If no file names are given as arguments (or if — is specified as the 
last argument), fb/ reads the standard input, so it may be used as a 
filter. When it is used with eqn(1) or negn, tb! should come first to 
minimize the volume of data passed through pipes. 


EXAMPLE 


If we let - represent a tab (which should be typed as a genuine tab), 
then the input: 


1S 

center box ; 

cBss 

cl | cls 

“lec 

LJ nn. 

Household Population 


Town-—Households 
+~Number-Size 
Bedminster-789-3.26 
Bernards Twp.-3087--3.74 
Bernardsville-2018-3.30 
Bound Brook-3425-3.04 


Bridgewater -7897-3.81 
Far Hills--240-3.19 
ste 
yields: os 
\ - 
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Household Population 
one Households 

| Number Size 
Bedminster 789 
Bernards Twp. 3087 
Bernardsville 2018 
Bound Brook 3425 
Bridgewater 7897 
Far Hills | 240 
SEE ALSO 


BUGS 
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ocw(1), eqn(1), mm(1), mmt(1), nroff(1), troff(1), mm(5), mv(5). 


See BUGS under nroff(1). 
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tc, otc — troff output interpreter 


SYNOPSIS 


te [ -t ] [ -olist ] [ -an ] [ -e ] [ file ] 
otc [ -t ] [ -sn ] [ -pl ] [ file ] 


DESCRIPTION 
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Tc interprets its input (standard input default) as output from troff(1). 
The standard output of tc is intended for a TEKTRONIX 4015 (a 4014 
terminal with ASCII and APL character sets). The various typesetter 
sizes are mapped into the 4014’s four sizes; the entire TROFF char- 
acter set is drawn using the 4014's character generator, using over- 
struck combinations where necessary, producing an altogether 
displeasing effect. Otc performs a similar function for the old 
TROFF, otroff (see nroff(1)). Typical usage: 


troff file | tc 
otroff -t file | otc 


At the end of each page tc waits for a new-line (empty line) from the 
keyboard before continuing on to the next page. In this wait state, 
the following commands are recognized: 


lcmd Send cmd to the shell. 


e Invert state of the screen erase (tc); do not erase screen 
before next page (ofc). 


—n Skip backward n pages. (fc only). 


n Print page n. (tc only). 

sn Skip forward n pages. (ofc only). 

an Set the aspect ratio ton. (fc only). 

? Print list of available options. (tc only). 


The command line options are: 
—t Do not wait between pages (for directing output into a file). 


—-Olist Prints only the pages enumerated in fist. The list consists 
of pages and page ranges (e.g., 5-17) separated by com- 
mas. The range n— goes from n to the end; the range —n 
goes from the beginning to and including page n. (fc only). 


—an Set the aspect ratio to n; default is 1.5. (tc only). 
—-e Do not erase before each page. (fc only). 
-sn Skip the first 7 pages. (ofc only). 
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—p/ Set page length to /; / may include the scale factors p 
a (points), i (inches), c (centimeters), and P (picas); Default is 
( picas. (otc only). 
~- SEE ALSO 
4014(1), nroff(1), tplot(1G), troff(1). 


BUGS 
Font distinctions are lost. 
It needs a —w option to wait for input to arrive. 
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NAME 

tee — pipe fitting 
SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 


DESCRIPTION 
Tee transcribes the standard input to the standard output and 
makes copies in the files . The -i option ignores interrupts; the —a 
option causes the output to be appended to the files rather than 
overwriting them. 
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NAME 
test — condition evaluation command Zoe 
SYNOPSIS a, 
test expr | 
[ expr ] 


DESCRIPTION 


Test evaluates the expression expr and, if its value is true, returns 
a zero (true) exit status; otherwise, a non-zero (false) exit status is 
returned; test also returns a non-zero exit status if there are no 
arguments. The following primitives are used to construct expr : 


-r file true if file exists and is readable. 
—w file true if file exists and is writable. 
—x file true if file exists and is executable. 
-f file true if file exists and is a regular file. 
—d file true if file exists and is a directory. 
—C file true if file exists and is a character special file. 
-b file true if file exists and is a block special file. 
—p file true if file exists and is a named pipe (fifo). 
—u file true if file exists and its set-user-ID bit is set. _, 
~g file true if file exists and its set-group-ID bit is set. . 
-k file true if file exists and its sticky bit is set. 
-S file true if file exists and has a size greater than zero. 
-t [ fildes | true if the open file whose file descriptor number is 

fildes (1 by default) is associated with a terminal dev- 

ice. 
—z sf true if the length of string s7 is zero. 
—n si true if the length of the string s7 is non-zero. 
st = s2 true if strings s7 and s2 are identical. 
s? != s2 true if strings s? and s2 are not identical. 
s7 true if s7 is not the null string. 
n1 -eqn2 __ true if the integers n? and n2 are algebraically equal. 

Any of the comparisons —ne , —gt , -ge , -It , and —-le 

may be used in place of -—eq . 

7 
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These primaries may be combined with the following 


operators: 
! unary negation operator. 
—-a binary and operator. 
—O binary or operator (—a has higher precedence than —o 


). 
( expr ) parentheses for grouping. 


Notice that all the operators and flags are separate arguments to 
test . Notice also that parentheses are meaningful to the shell and, 
therefore, must be escaped. 


SEE ALSO 
find(1), sh(1). 

WARNING 
In the second form of the command (i.e., the one that uses [] , 
rather than the word fest ), the square brackets must be delimited 
by blanks. 
Some UNIX systems do not recognize the second form of the com- 
mand. 
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NAME 
time — time a command 


SYNOPSIS 
time command 


DESCRIPTION 
The command is executed; after it is complete, time prints the 
elapsed time during the command, the time spent in the system, 
and the time spent in execution of the command. Times are 
reported in seconds. 


The times are printed on standard error. 


SEE ALSO 
timex(1). 
times(2) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
timex — time a command; report process data and system activity 


SYNOPSIS 
timex [options] command 


DESCRIPTION 
The given command is executed; the elapsed time, user time and 
system time spent in execution are reported in seconds. Optionally, 
process accounting data for the command and all its children can 
be listed or summarized, and total system activity during the execu- 
tion interval can be reported. 


The output of timex is written on standard error. 
Options are: 


-p __ List process accounting records for command and all its chil- 
dren. Suboptions f, h, k, m, r, and t modify the data items 
reported, as defined in acctcom (1). The number of blocks 
read or written and the number of characters transferred are 
always reported. 


-O Report the total number of blocks read or written and total 
characters transferred by command and all its children. 


-s Report total system activity (not just that due to command ) 
that occurred during the execution interval of command . All 
the data items listed in sar (7) are reported. 


SEE ALSO 
acctcom(1), sar(1). 


WARNING 
Process records associated with command are selected from the 
accounting file /usr’‘adm:pacct by inference, since process geneal- 
ogy is not available. Background processes having the same user- 
id, terminal-id, and execution time window will be spuriously 
included. 


EXAMPLES , 
A simple example: 


timex —ops sleep 60 


A terminal session of arbitrary complexity can be measured by tim- 
ing a sub-shell: 


timex —opskmt sh 


session commands 
EOT 
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toc — graphical table of contents routines 


SYNOPSIS 
dtoc [directory] 


ttoc mm-file 
vtoc [-cdhnimsvn] [TTOC file] 
DESCRIPTION | 

All of the commands listed below reside in /usr/bin/graf (See graph- 

ics (1G)). 

dtoc Dtoc makes a textual table of contents, TTOC, of ail sub- 
directories beginning at directory (directory defaults to .). 
The list has one entry per directory. The entry fields 
from left to right are level number, directory name, and 
the number of ordinary readable files in the directory. 
Dtoc is useful in making a visual display of all or parts of 
a file system. The following will make a visual display of 
all the readable directories under /: 

dtoc / | vtoc | td 

ttoc Output is the table of contents generated by the .TC 
macro of mm(1) translated to TTOC format. The input is 
assumed to be an mm file that uses the .H family of 
macros for section headers. If no file is given, the stan- 
dard input is assumed. 

vtoc Vtoc produces a GPS describing a hierarchy chart from a 
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TTOC. The output drawing consists of boxes containing 
text connected in a tree structure. If no file is given, the 
standard input is assumed. Each TTOC entry describes 
one box and has the form: id {line-weight,line- 
Style] “text” [mark] 

where: 


id is an alternating sequence of numbers and 
dots. The id specifies the position of the 
entry in the hierarchy. The /d Q. is the root 
of the tree. 
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line-weight _ is either: 
n, normal-weight; or 
m, medium-weight; or 
b, bold-weight. 
line-style is either: 
so, solid-line; 
do, dotted-line; 
dd, dot-dash line; 
da, dashed-line; or 
Id, long-dashed 


fext is a character string surrounded by quotes. 
The characters between the quotes 
become the contents of the box. To 
include a quote within a box it must be 
escaped (\"). 


mark is a character string (surrounded by quotes 
if it Contains spaces), with included dots 
being escaped. The string is put above the 
top right corner of the box. To include 
either a quote or a dot within a mark it 
must be escaped. 


Entry example: 1.1 b,da “ABC” DEF 
Entries may span more than one line by escaping the 
new-line (\new-line). 


Comments are surrounded by the /*,*/ pair. They may 
appear anywhere in a TTOC. 


Options: 

c Use text as entered (default is all upper case). 
d Connect the boxes with diagonal lines. 

hn ~~ Horizontal interbox space is 2% of box width. 
i Suppress the box /d. 

m Suppress the box mark. 

Ss Do not compact boxes horizontally. 


vn“ Vertical interbox space is n% of box height. 
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SEE ALSO 
graphics(1G). 
gps(4) in the Sys5 UNIX Programmer Reference Manual. 
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sie NAME 
( | touch — update access and modification times of a file 
— SYNOPSIS 
touch [ -—amc ] [ mmddhhmn yy] ] files 
DESCRIPTION 


Touch causes the access and modification times of each argument 
to be updated. The file name is created if it does not exist. If no 
time is specified (see date (1)) the current time is used. The -a 
and —m options cause touch to update only the access or modifica- 
tion times respectively (default is —am ). The -c option silently 
prevents touch from creating the file if it did not previously exist. 


The return code from touch is the number of files for which the 
times could not be successfully modified (including files that did not 
exist and were not created). 


SEE ALSO 
date(1). 
utime(2) in the UNIX System Programmer Reference Manual. 
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NAME 
tplot — graphics filters 


SYNOPSIS 
tplot [ -—T terminal [ -e raster | |] 


DESCRIPTION 
These commands read plotting instructions (see plot (4)) from the 
standard input and in general produce, on the standard output, plot- 
ting instructions suitabie for a particular terminal . \f no terminal is 
specified, the environment parameter $TERM (see environ (5)) is 
used. Known terminal s are: 


300 DASI 300. 

300S_  DASI 300s. 

450 DASI 450. 

4014 TEKTRONIX 4014. 

ver Versatec D1200A. This version of plot places a scan- 
converted image in /usr/tmp/raster $$ and sends the result 
directly to the plotter device, rather than to the standard out- 
put. The -e option causes a previously scan-converted file 
raster to be sent to the plotter. 


FILES 
/usr/lib/t300 
/usr/lib/t300s 
/usrlib/t450 
/usr/lib/t4014 
/usr/lib/vplot 
/usr/tmp/raster$$ 


SEE ALSO 
plot(3X), plot(4), term(5) in the Sys5 UNIX Programmer Reference 
Manual. 
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NAME 


tput — query terminfo database 


SYNOPSIS 


tput [ -T type ] capname 


DESCRIPTION 


Tput uses the terminfo(4) database to make terminal-dependent 
capabilities and information available to the shell. Jput outputs a 
string if the attribute (capability name) is of type string, or an integer 
if the attribute is of type integer. If the attribute is of type boolean, 
tput simply sets the exit code (0 for TRUE, 1 for FALSE), and does 
no output. 


-Ttype indicates the type of terminal. Normally this flag is 
unnecessary, as the default is taken from the environ- 
ment variable $TERM. 

Capname __ indicates the attribute from the terminfo database. See 
terminfo(4 ). 


EXAMPLES 


tput clear Echo clear-screen sequence for the current ter- 
minal. 

tput cols Print the number of columns for the current ter- 
minal. 

tput -T450 cols Print the number of columns for the 450 termi- 
nal. 

bold =‘tput smso‘ Set shell variable “bold” to stand-out mode 
sequence for current terminal. This might be 
followed by a prompt: 
echo “${bold}Please type in your name: \c” 

tput he Set exit code to indicate if current terminal is a 
hardcopy terminal. 


FILES 
/etc/term/?/* Terminal descriptor files 
/usr/include/term.h Definition files 
/usr/include/curses.h 

DIAGNOSTICS 


Page 1 


Tput prints error messages and returns the following error codes on 
error: 


-1 Usage error. 
-2 Bad terminal type. 
-3 Bad capname. 


In addition, if a capname is requested for a terminal that has no 
value for that capname (e.g., tput -T450 lines ), -1 Is printed. 
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SEE ALSO 


stty(1). 
terminfo(4) in the Sys5 UNIX Programmer Reference Manual. 
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NAME 
tr — translate characters 


SYNOPSIS 
tr [ —cds ] [ string! [ string2 ] ] 


DESCRIPTION 
Tr copies the standard input to the standard output with substitution 
or deletion of selected characters. Input characters found in string1 
are mapped into the corresponding characters of string2 . Any com- 
bination of the options —eds may be used: 


—C Complements the set of characters in string? with respect 
to the universe of characters whose ASCII codes are 001 
through 377 octal. 


—d Deletes all input characters in string? . 


—S Squeezes all strings of repeated output characters that are 
in string2 to single characters. 


The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 


[a-z] Stands for the string of characters whose ASCII codes run 
from character a to character z , inclusive. 


[a+n] Stands for rn repetitions of a. If the first digit of n is 0,7/ is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding string2 . 


The escape character \ may be used as in the shell to remove spe- 
cial meaning from any character in a string. In addition, \ followed 
by 1, 2, or 3 octal digits stands for the character whose ASCII code 
is given by those digits. 

The following example creates a list of all the words in file7 one per 
line in file2, where a word is taken to be a maximal string of alpha- 
betics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline. 


tr cs “[A-Z][a-z]" "[\012*]" <file1 >file2 
SEE ALSO 


ed(1), sh(1). 
ascii(5) in the Sys5 UNIX Programmer Reference Manual. 


BUGS | 
Will not handle ASCII NUL in string? or string2 ; always deletes NUL 
from input. | 
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NAME 


troff — text formatting and typesetting 


SYNOPSIS 


troff [ option ] .... [ file ] ... 


DESCRIPTION 


FILES 
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Troff formats text in the named files for printing on a photo- 
typesetter. It is the new "device-independent” version of the old ofr- 
off (see nroff(1)). Its capabilities are described in the NROFF/TROFF 
User Manual plus the Addendum. 


If no file argument is present, the standard input is read. An argu- 
ment consisting of a single minus (—) is taken to be a file name 
corresponding to the standard input. The options, which may 
appear in any order so long as they appear before the files, are: 


—Olist Print only pages whose page numbers appear in the 
comma-separated /ist of numbers and ranges. A range 
N-M means pages N through M; an initial -N means from 
the beginning to page N; and a final N— means from N to 
the end. (See BUGS below.) 


—nN Number first generated page N. 


—sN Generate output to encourage typesetter to stop every N 
pages. 


—mname Prepend the macro file /usr/lib/tmac/tmac.name to the 
input files. 


—raN Set register a (one character name) to N. 
i Read standard input after the input files are exhausted. 


-q Invoke the simultaneous input-output mode of the .rd 
request. 

—Z Print only messages generated by .tm requests. 

-a Send a printable ASCII approximation of the results to the 


standard output. 


-Tdest Prepare output for typesetter dest. Currently the only sup- 
ported typesetter is the Autologic APS-5, (-Taps). Users 
of the Wang CAT should use otroff (see nroff(1)). Sup- 
ported laser printers are the Imagen Imprint -10 (-—T/70) 
and the Xerox 9700 (see dx9700(1)). 


/tmp/trtmp* temporary file 
/usr/ib/Atmac/itmac.* standard macro files 
/usr/lib/macros/« standard macro files 
/usr/lib/font/dev*/* — font width tables 
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SEE ALSO 


( 


BUGS 


dx9700(1), eqn(1), mmt(1), nroff(1), pic(1), tbl(1), tce(1). 
NROFF/TROFF User Manual with Addendum on the device- 
independent TROFF and A TROFF Tutorial . 


The .tl request may not be used before the first break-producing 
request in the input to troff. 


Troff believes in Eastern Standard Time; as a result, depending on 
the time of the year and on your local time zone, the date that troff 
generates may be off by one day from your idea of what the date is. 


When troff is used with the —olist option inside a pipeline (e.g., with 
one or more of pic(1), eqn(1), and fb/(1)), it may cause a harmless 
“broken pipe” diagnostic if the last page of the document is not 
specified in ist. 
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NAME 
true, false — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
True does nothing, successfully. False does nothing, unsuccess- 
fully. They are typically used in input to sh (7) such as: 


while true 
do 
command 
done 
SEE ALSO 
sh(1). 
DIAGNOSTICS 


True has exit status zero, false nonzero. 
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NAME 


tset — set terminal modes 


SYNOPSIS 


/usr/p\x/tset [ -— ] [ —hrs!QS ] [ —e[c] ] [ —E[c] ] 
[ -k[c] ] [ —m [/dent][test baudrate]:type ]| [ type ] 


DESCRIPTION 
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Tset Causes terminal dependent processing such as setting erase 
and kill characters, setting or resetting delays, and the like. It is 
driven by the /etc/ttytype and /etc/termcap files. 


The type argument specifies the type of terminal. The type may be 
any type given in /etc/termcap. If type is not specified, the terminal 
type is read from the environment TERM, unless the —h flag is set 
or any —m argument was given. In this case the type is read from 
/etc/ttytype (the data base that links port names to terminal types). 
The port name is determined by a ttyname(3) call on the diagnostic 
output. If the port is not found in /etc/ttytype, the terminal type is 
set to unknown. 


Ports for which the terminal type is indeterminate are identified in 
/etc/ttytype as dialup, plugboard, etc. You can specify how these 
identifiers should map to an actual! terminal type. The mapping flag, 
—m, is followed by the appropriate identifier (a 4 character or longer 
substring is adequate), an optional test for baud rate, and the termi- 
nal type to be used if the mapping conditions are satisfied. If more 
than one mapping is specified, the first correct mapping prevails. A 
missing identifier matches all identifiers. Baud rates are specified 
as with stty(1), and are compared with the speed of the diagnostic 
output. The test may be any combination of: >, =, <, @, and !. 
(Note: @ is a synonym for = and ! inverts the sense of the test. 
Remember to escape characters meaningful to the shell.) 


If the type as determined above begins with a question mark, fset 
asks if you really want that type. A null response means to use that 
type; otherwise, another type can be entered, which is then used 
instead. (The question mark must be escaped to prevent filename 
expansion by the shell.) 


On terminals that can backspace but not overstrike (such as a CRT), 
and when the erase character is the default erase character (‘#’ on 
standard systems), the erase character is changed to a Control-H 
(backspace). The —e flag sets the erase character to be the named 
character c on all terminals, so to override this option you can say 
—e#. The default for c is the backspace character on the terminal, 
usually Control-H. The —E flag is identical to -e except that it only 
operates on terminals that can backspace; it might be used with an 
ASR33. The —k option works similarly, with c defaulting to Control- 
X. No kill processing is done if —k is not specified. In all of these 
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flags, ‘““X”, where X is any character, is equivalent to control-X. 


The — option prints the terminal type on the standard output; this 
can be used to get the terminal type by saying: 


set termtype = ‘tset - 


If no other options are given, tset operates in “fast mode” and only 
outputs the terminal type, bypassing all other processing. 


The —s outputs export and assignment commands (if your default 
shell is the Bourne shell). Use: 


tset -s ... > /Amp/tset$$ 
/tmp/tset$$ 
rm /tmp/tset$$ 


For the same effect, if you are using csh, use: 


set noglob 

set term=('tset -S ....’) 
setenv TERM $term[1] 
setenv TERMCAP "$term[2]" 
unset term 

unset noglob 


The —S option only outputs the strings to be placed in the environ- 
ment variables. 


The -r option prints the terminal type on the diagnostic output. 


The —Q option supresses printing the “Erase set to” and “Kill set to” 
messages. 


The -l option supresses outputing the terminal initialization strings. 


Tset is most useful when included in the .login (for csh(1)) or .pro- 
file (for sh(1)) file executed automatically at login, with -m mapping 
used to specify the terminal type you most frequently dial in on. 


EXAMPLES 


FILES 


NOTES 


tset gt42 
tset —mdialup\>300:adm3a —mdialup:dw2 —Qr -e# 
tset —m dial:ti733 —m plug:\?hp2621 —m unknown:\? —e -k’U 


/etc/ttytype Port name to terminal type map database 
fetc/termcap =‘ Terminal capability database 


This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 
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SEE ALSO 
7 csh(1), stty(1). | 
( termcap(5), ttytype(5) in the Sys5 UNIX Programmer's Reference 
y Manual. 


NOTES 
For compatibility with earlier versions of tset, the following flags are 
accepted and mapped internally as shown: 


-dtype -> -mdialup:type 
-p type -> -m plugboard:type 
-atype -> -m arpanet:type 


These flags will disappear eventually. 
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NAME 
tsort — topological sort 

SYNOPSIS 
tsort [ file ] 

DESCRIPTION 
Tsort produces on the standard output a totally ordered list of items 
consistent with a partial ordering of items mentioned in the input file 
. If no file is specified, the standard input is understood. 
The input consists of pairs of items (nonempty strings) separated by 
blanks. Pairs of different items indicate ordering. Pairs of identical 
items indicate presence, but not ordering. 

SEE ALSO 
lorder(1). 

DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 

BUGS 


Uses a quadratic algorithm; not worth fixing for the typical use of 
ordering a library archive file. , 
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NAME 
( 7 tty — get the name of the terminal 

SYNOPSIS 
tty [ -I][-s ] 

DESCRIPTION 
Tty prints the path name of the user's terminai. The -l option prints 
the synchronous line number to which the user's terminal is con- 
nected, if it is on an active synchronous line. The —s option inhibits 
printing of the terminal path name, allowing one to test just the exit 
code. 

EXIT CODES 
2 if invalid options were specified, 
0 if standard input is a terminal, 
1 otherwise. 


DIAGNOSTICS 
“not a tty” if the standard input is not a terminal and —s is not speci- 


fied. 
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NAME 

umask — set file-creation mode mask 
SYNOPSIS 

umask [ 000 | 
DESCRIPTION 


The user file-creation mode mask is set to ooo . The three octal 
digits refer to read. write execute permissions for Owner , group , 
and others , respectively (see chmod (2) and umask (2)). The value 
of each specified digit is subtracted from the corresponding “digit” 
specified by the system for the creation of a file (see creat (2)). For 
example, umask 022 removes group and others write permission 
(files normally created with mode 777 become mode 755 ;; files 
created with mode 666 become mode 644 ). 


If oo00 is omitted, the current value of the mask is printed. 
Umask is recognized and executed by the shell. 


SEE ALSO 
chmod(1), sh(1). 
chmod(2), creat(2), umask(2) in the Sys5 UNIX Programmer Refer- 
ence Manual. 
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NAME 


( SYNOPSIS 


DESCRIPTION 
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uname — print name of current UNIX system 


uname [ —Snrvma |] 


Uname prints the current system name of the UNIX system on the 
standard output file. It is mainly useful to determine which system 
one is using. The options cause selected information returned by 
uname (2) to be printed: 


—-S 


—-n 


“al 


SEE ALSO 
uname({2) in the Sys5 UNIX Programmer Reference Manual. 


Page 1 


print the system name (default). 


print the nodename (the nodename may be a name that the 
system is known by to a communications network). 


print the operating system release. 
print the operating system version. 
print the machine hardware name. 


print all the above information. 
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NAME 
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unget — undo a previous get of an SCCS file 


SYNOPSIS 


unget [-rsSiD] [-s] [-n] files 


DESCRIPTION 
Unget undoes the effect of a get -e done prior to creating the 
intended new delta. If a directory is named, unget behaves as 
though each file in the directory were specified as a named file, 
except that non-SCCS files and unreadable files are silentiy ignored. 
lf a name of — is given, the standard input is read with each line 
being taken as the name of an SCCS file to be processed. 


Keyletter arguments apply independently to each named file. 


SEE ALSO 


—rS/D 


—-S 


—-n 


Uniquely identifies which delta is no longer 
intended. (This would have been specified by 
get as the “new delta’). The use of this 
keyletter is necessary only if two or more out- 
standing get s for editing on the same SCCS file 
were done by the same person (login name). A 
diagnostic results if the specified S/D is ambigu- 
ous, or if it is necessary and omitted on the com- 
mand line. 


Suppresses the printout, on the standard output, 
of the intended delta’s S/D . 


Causes the retention of the gotten file which 
would normally be removed from the current 
directory. 


delta(1), get(1), help(1), sact(1). 


DIAGNOSTICS 
Use help (1) for explanations. 
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NAME 


uniq — report repeated lines in a file 


SYNOPSIS 


uniq | -udc [ + n][-n]][ input [ output | |] 


DESCRIPTION 


Unig reads the input file comparing adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are 
removed; the remainder is written on the output file. /nput and 
output should always be different. Note that repeated lines must be 
adjacent in order to be found; see sort (7). If the —u flag is used, 
just the lines that are not repeated in the original file are output. 
The -—d option specifies that one copy of just the repeated lines is to 
be written. The normal mode output is the union of the —u and —d 
mode outputs. 


The -c option supersedes -—u and -d and generates an output 
report in default style but with each line preceded by a count of the 
number of times it occurred. 


The n arguments specify skipping an initial portion of each line in 
the comparison: 


—n The first 1 fields together with any blanks before each are 
ignored. A field is defined as a string of non-space, non- 
tab characters separated by tabs and spaces from its 
neighbors. 


+n The first nm characters are ignored. Fields are skipped 
before characters. 


SEE ALSO 
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comm(1), sort(1). 
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NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 
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Units converts quantities expressed in various standard scales to 
their equivalents in other scales. It works interactively in this 
fashion: 


You have: inch 

You want: cm 
* 2.540000e+ 00 
/ 3.937008e-01 


A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated 
by suffixed positive integers, division by the usual sign: 


You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+ 00 

/ 9.797299e-01 


Units only does multiplicative scale changes; thus it can convert 
Kelvin to Rankine, but not Celsius to Fahrenheit. Most familiar 
units, abbreviations, and metric prefixes are recognized, together 
with a generous leavening of exotica and a few constants of nature 
including: 


pi ratio of circumference to diameter, 
Cc speed of light, 

e charge on an electron, 

g acceleration of gravity, 


force sameasg, 

mole Avogadro's number, 

water pressure head per unit height of water, 
au astronomical unit. 


Pound is not recognized as a unit of mass; lb is. Compound 
names are run together, (e.g., lightyear ). British units that differ 
from their U.S. counterparts are prefixed thus: brgallon . For a com- 
plete list of units, type: | 


cat /usr/lib/unittab 


/usr/lib/unittab 
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NAME 
uucp, uulog, uuname — UNIX system to UNIX system copy 


SYNOPSIS 
uucp [ options | source-files destination-file 


uulog [ options | 
uuname [ -l ] [ -v ] 


DESCRIPTION 
Uucp. 
Uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 


system-name!path-name 


where system-name is taken from a list of system names which 
uucp knows about. The system-name may also be a list of names 
such as 


in which case an attempt is made to send the file via the specified 
route, and only to a destination in PUBDIR (see below). Care should 
be taken to insure that intermediate nodes in the route are willing to 
foward information. 


The shell metacharacters ? , * and [...] appearing in path-name 
will be expanded on the appropriate system. 


Path names may be one of: 
(1) a full path name; 


(2) a path name preceded by “user where user is a 
login name on the specified system and is replaced 
by that user’s login directory; 


(3) a path name preceded by /user where user Is a 
login name on the specified system and is replaced 
by that user's directory under PUBDIR; 


(4) anything else is prefixed by the current directory. 


lf the result is an erroneous path name for the remote system the 
copy will fail. If the destination-file is a directory, the last part of the 
source-file name is used. 


Uucp preserves execute permissions across the transmission and 
gives 0666 read and write permissions (see chmod (2)). — 


The following options are interpreted by uucp : 
—d Make all necessary directories for the file copy (default). 
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—f Do not make intermediate directories for the file copy. 

—C Use the source file when copying out rather than copying “ > 
the file to the spool directory (default). ee 

—C Copy the source file to the spool directory. 


—mfile Report status of the transfer in file. If file is omitted, send 
mail to the requester when the copy is completed. 


—nuser Notify user on the remote system that a file was sent. 


-—esys Send the uucp command to system sys to be executed 
there. (Note: this will only be successful if the remote 
machine allows the uucp command to be executed by 
/usr/lib/uuc p/uuxat . ) 


—f Queue job but do not start file transfer process. By default 
a file transfer process starts each time uucp is evoked. 

—j Control writing of the uucp job number to standard output 
(see below). 


Uucp associates a job number with each request. This job number 
can be used by uustat to obtain status or terminate the job. 


The environment variable JOBNO and the -j option are used to con- 
trol the listing of the uucp job number on standard output. If the - ~ 
environment variable JOBNO is undefined or set to OFF, the job 


number will not be listed (default). If uucp is then invoked with the ~~ 
-j option, the job number will be listed. If the environment variable 
JOBNO is set to ON and is exported, a job number will be written to 
standard output each time uucp is invoked. In this case, the -j 
option will supress output of the job number. 
Uulog | 
Uulog queries a summary log of uucp and uux (1C) transactions in 
the file /usr/s pool/uuc p/LOGFILE. 
The options cause uulog to print logging information: 
-—ssys Print information about work involving system sys. If sys is 
not specified, logging information for all systems will be 
printed. | 
—uuser Print information about work done for the specified, user . If 
user is not specified then logging information for all users 
will be printed. 
Uuname. 
Uuname lists the uucp names of known systems. The —I option - 
a 


returns the local system name. The —v option will print additional / 
information about each system. A description will be printed for 
each system that has a line of information in /usr/lib/uucp/ADMIN. 


The format of ADMIN is: sysname tab description tab. 
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FILES 
7 /usr/spool/uucp spool directory 
( /usr/spool/uucppublic public directory for receiving and sending 
(PUBDIR) 
/usr/lib/uucp/* other data and program files 
/usr/spool/uucp/SEQF a sequence file containing a_ four-digit 
number used by uucico(1m) or uux(ic) to 
record work done by programs 
SEE ALSO 


mail(1), uux(1C). 
chmod(2) in the Sys5 UNIX Programmer Reference Manual. 


WARNING 

The domain of remotely accessible files can (and for obvious secu- 
rity reasons, usually should) be severely restricted. You will very 
likely not be able to fetch files by path name; ask a responsible per- 
son on the remote system to send them to you. For the same rea- 
sons, you will probably not be able to send files to arbitrary path 
names. As distributed, the remotely accessible files are those 
whose names begin /usr/spool/uucppublic (equivalent to “nuucp or 
just ~ ). 

Only the first six characters of a system-name are significant. Any 

( excess characters are ignored. 


NOTES 
In order to send files that begin with a dot (e.g., .profile) the files 
must by qualified with a dot. For example: .profile, are correct; 
whereas “prof*, ?profile are incorrect. 


Uucp will not generate a job number for a strictly local transaction. 


BUGS 
All files received by uucp will be owned by uucp . 
The —m option will only work sending files or receiving a single file. 
Receiving multiple files specified by special shell characters ? + 
[...] will not activate the —m option. 
The —m option will not work if all transactions are local or if uucp is 
executed remotely via the —e option. 
The —n option will function only when the source and destination are 
not on the same machine. 
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NAME 


uuencode, uudecode — encode/decode a binary file for transmission 
via mail 


SYNOPSIS 


uuencode [ source ] remotedest | mail sys1!sys2!..!decode 
uudecode | file | 


DESCRIPTION 


Uuencode and uudecode are used to send a binary file via uucp (or 
other) mail. This combination can be used over indirect mail links 
even when uusend(1C) is not available. 


Uuencode takes the named source file (default standard input) and 
produces an encoded version on the standard output. The encoding 
uses only printing ASCII characters, and includes the mode of the 
file and the remotedest for recreation on the remote system. 


Uudecode reads an encoded file, strips off any leading and trailing 
lines added by mailers, and recreates the original file with the speci- 
fied mode and name. 


The intent is that all mail to the user “decode” should be filtered 
through the uudecode program. This way the file is created 
automatically without human intervention. This is possible on the 
uucp network by either using sendmail or by making rmail be a link 
to Mail instead of mail. In each case, an alias must be created in a 
master file to get the automatic invocation of uudecode. 


If these facilities are not available, the file can be sent to a user on 
the remote machine who can uudecode it manually. 


The encode file has an ordinary text form and can be edited by any 
text editor to change the mode or remote name. 


SEE ALSO 


BUGS . 
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mail(1), uucp(1C), uwencode(1C), uux(1C). 


The file is expanded by 35% (3 bytes become 4 plus control infor- 
mation) causing it to take longer to transmit. 


The user on the remote system who is invoking uudecode (often 
uucp) must have write permission on the specified file. 
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uustat — uucp status inquiry and job control 


SYNOPSIS 


uustat [ options | 


DESCRIPTION 


Uustat will display the status of, or cancel, previously specified 
uucp commands, or provide general status on uucp connections to 
other systems. The following options are recognized: 


—jjobn 


—-kjobn 


-rjobn 


—Chour 
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Report the status of the uucp request jobn . If all is 
used for jobn , the status of all uucp requests is 
reported. An argument must be supplied otherwise the 
usage message will be printed and the request will fail. 
Kill the uucp request whose job number is jobn . The 
killed uucp request must belong to the person issuing 
the uustat command unless one is the super-user. 
Rejuvenate jobn. That is, jobn is touched so that its 
modification time is set to the current time. This 
prevents uuclean from deleting the job until the jobs 
modification time reaches the limit imposed by uucfean. 
Remove the status entries which are older than hour 
hours. This administrative option can only be initiated by 
the user uucp or the super-user. 

Report the status of all uuco requests issued by user . 
Report the status of all uucp requests which communi- 
cate with remote system sys . 

Report the status of all uucp requests which are older 
than Aour hours. 

Report the status of all uucp requests which are younger 
than hour hours. 

Report the status of accessibility of machine mch . lf 
mch is specified as all , then the status of all machines 
known to the local uucp are provided. 

This is the same as the —m option except that two times 
are printed. The time that the last status was obtained 
and the time that the last successful transfer to that sys- 
tem occurred. 

Report the uucp status using the octal status codes 
listed below. If this option is not specified, the verbose 
description is printed with each uucp request. 

List the number of jobs and other control files queued for 
each machine and the time of the oldest and youngest 
file queued for each machine. If a lock file exists for that 
system, its date of creation is listed. 
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When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. Note that only one of the 
options -j , -m , —k , -c , -r , can be used with the rest of the other 
options. 


For example, the command: 
uustat —uhdc —smhtsa -y72 


will print the status of all uucp requests that were issued by user 
hdc to communicate with system mhtsa within the last 72 hours. 
The meanings of the job request status are: 


job-number user remote-system command-time status-time status 


where the status may be either an octal number or a verbose 


a a \, 
/ \ 
f 


description. The octai code corresponds to the following descrip- 
tion: 

OCTAL STATUS 

000001 the copy failed, but the reason cannot be deter- 

mined 

000002 _—spermission to access local file is denied 

000004 permission to access remote file is denied 

000010 bad uucp command is generated 

000020 remote system cannot create temporary file fo 

000040 _— cannot copy to remote directory : 

000100 cannot copy to loca! directory 

000200 _ _—ilocal system cannot create temporary file 

000400 = cannot execute uucp 

001000 ~=copy (partially) succeeded 

002000 = copy finished, job deleted 

004000 _—sijob is queued 

010000 = job killed (incomplete) 

020000 job killed (complete) 


The meanings of the machine accessibility status are: 


system-name time status 


where fime is the latest status time and status is a self-explanatory 
description of the machine status. 


FILES 
/USf, Spool’ uuUCp spool directory 
‘usrilib; uucp;L_stat system status file 
/usrilib;uucp, R_stat request status file 
SEE ALSO 
uucp(1C). 
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NAME 


uuto, uupick — public UNIX-to-UNIX system file copy 


SYNOPSIS 


uuto [ options | source-files destination 
uupick [ —s system | 


DESCRIPTION 
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Uuto sends source-files to destination . Uuto uses the uucp (1C) 
facility to send files, while it allows the local system to control the file 
access. A source-file name is a path name on your machine. Des- 
tination has the form: 

system!user 


where system is taken from a list of system names that uucp 
knows about (see uuname ). Logname is the login name of some- 
one on the specified system. 


Two options are available: 


—p Copy the source file into the spool directory before 
transmission. 
—m Send mail to the sender when the copy is complete. 


The files (or sub-trees if directories are specified) are sent to PUB- 
DIR on system , where PUBDIR is a public directory defined in the 
uucp source. Specifically the files are sent to 


PUBDIR: receive, user.mysystem files. 
The destined recipient is notified by mail (1) of the arrival of files. 


Uupick accepts or rejects the files transmitted to the user. Specifi- 
cally, uupick searches PUBDIR for files destined for the user. For 
each entry (file or directory) found, the following message is printed 
on the standard output: 

from system: [file file-name |] [dir dirname] ? 


Uupick then reads a line from the standard input to determine the 
disposition of the file: 


<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir | Move the entry to named directory dir (current 
directory is default). 

a[ dir | Same as m except moving all the files sent from 
system . 

p Print the content of the file. 
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q Stop. 

EOT (control-d) Sameasq. 

lcommand Escape to the shell to do command . 
‘ Print a command summary. 


Uupick invoked with the -—ssystem option will only search the PUB- 
DIR for files sent from system . 


FILES 
PUBDIR /usr/spool uucppublic public directory 


NOTES 
In order to send files that begin with a dot (e.g., .profile) the files 
must by qualified with a dot. For example: .profile, .prof*, .profil? 
are correct; whereas “prof*, ?profile are incorrect. 


SEE ALSO 
mail(1), uucp(1C), uustat(1C), uux(1C). 
uuclean(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 


( SYNOPSIS 


uux — UNIX-to-UNIX system command execution 


uux [ options |] command-string 


DESCRIPTION 
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Uux will gather zero or more files from various systems, execute a 
command on a specified system and then send standard output to a 
file on a specified system. Note that, for security reasons, many 
installations will limit the list of commands executable on behalf of 
an incoming request from uux . Many sites will permit little more 
than the receipt of mail (see mail (7)) via uux . 


The command-string is made up of one or more arguments that 
look like a Shell command line, except that the command and file 
names may be prefixed by system-name!. A null system-name is 
interpreted as the local system. 


File names may be one of 
(1) a full path name; 


(2) a path name preceded by “xxx where xxx is a login 
name on the specified system and is replaced by that user's 
login directory; 


(3) anything else is prefixed by the current directory. 
As an example, the command 
uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff" 


will get the f1 files from the “usg” and “pwba” machines, execute a 
diff command and put the results in f1.diff in the local directory. 


Any special shell characters such as <>;]| should be quoted either 
by quoting the entire commanda-string, or quoting the special char- 
acters as individual arguments. 


Uux will attempt to get all files to the execution system. For files 
which are output files, the file name must be escaped using 
parentheses. For example, the command 


uux aluucp b!/usr/file \(c!/usr/file\) 


will send a uucp command to system “a” to get /usr/file from sys- 
tem “b” and send it to system “c”. 


Uux will notify you if the requested command on the remote system 
was disallowed. The response comes by remote mail from the 
remote machine. Executable commands are listed in 
/usr/lib/uucp/L.cmds on the remote system. The format of the 
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L.cmdis file is: 
cmd,machine1,machinea2.... a 


lf no machines are specified, then any machine can execute cmd. ed 
If machines are specified, only the listed machines can execute 

cmd. If the desired command is not listed in L.cmds then no 
machine can execute that command. 


Redirection of standard input and output is usually restricted to files 
in PUBDIR. Directories into which redirection is allowed must be | 
specified in /usr/lib/uucp/USERFILE by the system administrator. 

See the UUCP Administrator Manual in the Sys5 UNIX Administrator 

Guide. 


The following options are interpreted by uux : 


_ The standard input to uux is made the standard input to the 
commana-:string . 


—n Send no notification to user. 


-mfile Report status of the transfer in file. If file is omitted, send 
mail to the requester when the copy is completed. 


| Control writing of the uucp job number to standard output. 
Uux associates a job number with each request. This job number 


can be used by uustat to obtain status or terminate the job. q - 
The environment variable JOBNO and the —j option are used to con- re 
trol the listing of the uwux job number on standard output. If the 
environment variable JOBNO is undefined of set to OFF, the job 
number will not be listed (default). If uuco is then invoked with the 
—j option, the job number will be listed. If the environment variable 
JOBNO is set to ON and Is exported, a job number will be written to 
standard output each time uux is invoked. In this case, the -j 
option will suppress output of the job number. 

FILES 
/usr/spool/uucp spool directory 
/usr/spool/uucppublic public directory (PUBDIR) 
/usr/ib/uucp/* other data and programs 

SEE ALSO | 
mail(1), uuclean(1M), uucp(1C). 

BUGS 
Only the first command of a shell pipeline may have a system- 
name!. All other commands are executed on the system of the first 
command. Pe 
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The use of the shell metacharacter * will probably not do what you 
want it to do. The shell tokens << and >> are not implemented. 
Only the first six characters of the system-name are significant. Any 
excess characters are ignored. 
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NAME 
val — validate SCCS file 


SYNOPSIS 
val — 
val [-s] [-rsiD] [-mname] [—ytype] files 


DESCRIPTION 
Val determines if the specified file is an SCCS file meeting the 
characteristics specified by the optional argument list. Arguments to 
val may appear in any order. The arguments consist of keyletter 
arguments, which begin with a —, and named files. 


Vail has a special argument, -, which causes reading of the stan- 
dard input until an end-of-file condition is detected. Each line read 
is independently processed as if it were a command line argument 
list. 


Val generates diagnostic messages on the standard output for each 
command line and file processed, and also returns a single 8-bit 
code upon exit as described below. 


The keyletter arguments are defined as follows. The effects of any 
keyletter argument apply independently to each named file on the 
command line. | 


-S The presence of this argument silences the 
diagnostic message normally generated on 
the standard output for any error that is 
detected while processing each named file on 
a given command line. 


-rsiD The argument value S/ID (SCCS /Dentificatio 
String) is an SCCS delta number. A check is 
made to determine if the S/D is ambiguous (e. 
g., r1 is ambiguous because it physically 
does not exist but implies 1.1, 1.2, etc., which 
may exist) or invalid (e. g., r1.0 or r1.1.0 are 
invalid because neither case can exist as a 
valid delta number). If the S/D is valid and 
not ambiguous, a check is made to determine 
if it actually exists. 


—-mname The argument value name is compared with 
the SCCS %M% keyword in file . 
-ytype The argument value type is compared with 


the SCCS %Y% keyword in file . 
The 8-bit code returned by val is a disjunction of the possible errors, 
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l.e€., Can be interpreted as a bit string where (moving from left to 
right) set bits are interpreted as follows: 


bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 
bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = SID Is invalid or ambiguous; 

bit 5 = S/D does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, —m mismatch: 


Note that va/ can process two or more files on a given command 
line and in turn can process multiple command lines (when reading 
the standard input). In these cases an aggregate code is returned — 
a logical OR of the codes generated for each command line and file 
processed. 


SEE ALSO 

admin(1), delta(1), get(1), help(1), prs(1). 
DIAGNOSTICS 

Use help (1) for explanations. 


BUGS 
Val can process up to 50 files on a single command line. Any 
number above 50 will produce a core dump. 
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vc — version control 


SYNOPSIS 


ve [—a] [-t] [—-cchar] [-s] [keyword=value ... keyword=value] 


DESCRIPTION 
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The vc command copies lines from the standard input to the stan- 
dard output under control of its arguments and controi statements 
encountered in the standard input. In the process of performing the 
copy operation, user declared keywords may be replaced by their 
string value when they appear in plain text and/or control state- 
ments. 


The copying of lines from the standard input to the standard output 
is conditional, based on tests (in control statements) of keyword 
values specified in control statements or as vc command argu- 
ments. 


A control statement is a single line beginning with a control charac- 
ter, except as modified by the -t keyletter (see below). The default 
control character is colon (:), except as modified by the -c keyletter 
(see below). Input lines beginning with a backslash (\) followed by a 
control character are not control lines and are copied to the stan- 
dard output with the backslash removed. Lines beginning with a 
backslash followed by a non-control character are copied in their 
entirety. 


A keyword is composed of 9 or less alphanumerics; the first must 
be alphabetic. A value is any ASCII string that can be created with 
ed (1); a numeric value is an unsigned string of digits. Keyword 
values may not contain blanks or tabs. 


Replacement of keywords by values is done whenever a keyword 
surrounded by control characters is encountered on a version con- 
trol statement. The —a keyletter (see below) forces replacement of 
keywords in all lines of text. An uninterpreted control character may 
be included in a value by preceding it with \. If a literal \ is desired, 
then it too must be preceded by \. 


Keyletter Arguments 


—a Forces replacement of keywords surrounded 
by control characters with their assigned 
value in a/f text lines and not just in vc state- 
ments. | 
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7 —t All characters from the beginning of a line up 
( | to and including the first tab character are 

ignored for the purpose of detecting a control 
statement. If one is found, all characters up 
to and including the tab are discarded. 


—cchar Specifies a control character to be used in 
place of :. 
-S Silences warning messages (not error) that 


are normally printed on the diagnostic output. 
Version Control Statements 


:dcl keyword{, ..., Keyword] 
Used to declare keywords. All keywords must be declared. 


:asg keyword=value 
Used to assign values to keywords. An asg statement over- 
rides the assignment for the corresponding keyword on the vc 
command line and all previous asg ’s for that keyword. Key- 
words declared, but not assigned values have null values. 


if condition 


end 

( se ie Used to skip lines of the standard input. If the condition is true 
all lines between the if statement and the matching end state- 
ment are copied to the standard output. If the condition is 
false, all intervening lines are discarded, including control 
statements. Note that intervening /f statements and matching 
end statements are recognized solely for the purpose of main- 
taining the proper if-end matching. 

The syntax of a condition is: 


<cond> ::= [ "not" ] <or> 

<or> = <and> ji <and> "|" <or> 

<and> = <exp> | <exp> "&" <and> 

<exp> = "(" <or> ")" | <value> <op> <value> 
<op> = Ren] a" hc | 

<value> ::= <arbitrary ASCII string> | <numeric string> 


The available operators and their meanings are: 


= equal 

| = not equal 
& and 
| or 
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greater than 
less than 
used for logical groupings Qo 
may only occur immediately after the /f, anc 
when present, inverts the value of the 
entire condition 


BoAV 


The > and < operate only on unsigned integer values (e.g., : 
012 > 12 is false). All other operators take strings as argu- 
ments (e.g., : 012 != 12 is true). The precedence of the 
operators (from highest to lowest) is: 

=l=>< all of equal precedence 

& 

| 
Parentheses may be used to alter the order of precedence. 
Values must be separated from operators or parentheses by 
at least one blank or tab. 

:itext 

Used for keyword replacement on lines that are copied to the 
standard output. The two leading control characters are 
removed, and keywords surrounded by control characters in 
text are replaced by their value before the line is copied tothe ~~ 
output file. This action is independent of the —a keyletter. 


on 
:off 

Turn on or off keyword replacement on all lines. 
:ctl char 


Change the control character to char. 


:msg message 
Prints the given message on the diagnostic output. 


\ 
OE ey 
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"err message 
Prints the given message followed by: 
ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an 
exit code of 1. 


SEE ALSO 

ed(1), help(1). 
DIAGNOSTICS 

Use he/lp(1) for explanations. 


EXIT CODES 
0 — normal 
1 — any error 
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vi — screen-oriented (visual) display editor based on ex 


SYNOPSIS 


vi [ -t tag |] [ -r file ] [ -1 ] [ -wn ] [ -x ] [ -—R ] [ +command 
] name ... 

view [ -t fag |] [ -r fle |] [ -1 ] [ -wn ] [ -x ] [ -R ] [ +com- 
mand | name ... 

vedit [ -t tag ] [ -r file ] [| -l ] [ -wn ] [ -x ] [ -R |] [ +com- 
mand | name ... 


DESCRIPTION 


Vi (visual) is a display-oriented text editor based on an underlying 
line editor ex (7). It is possible to use the command mode of ex 
from within wi and vice-versa. 


When using wi , changes you make to the file are reflected in what 
you see on your terminal screen. The position of the cursor on the 
screen indicates the position within the file. The Vi Quick Reference 
card, the Introduction to Display Editing with Vi and the Ex Refer- 
ence Manual provide full details on using wi. 


INVOCATION 
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The following invocation options are interpreted by vi : 


—t tag Edit the file containing the tag and position the edi- 
tor at its definition. 


—rfile Recover file after an editor or system crash. If file 
is not specified a list of all saved files will be 
printed. 


—| LISP mode; indents appropriately for lisp code, the 
() {} [[ and ]] commands in wi and open are modi- 
fied to have meaning for lisp . 


—-wn Set the default window size to n. This is useful 
when using the editor over a slow speed line. 


-X Encryption mode; a key is prompted for allowing 
creation or editing of an encrypted file. 


—-R Read only mode; the readonly flag is set, prevent- 
ing accidental overwriting of the file. 


+command The specified ex command is interpreted before 
editing begins. 


The name argument indicates files to be edited. 


The view invocation is the same as wi except that the readonly flag 
is set. 
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The vedit invocation is intended for beginners. The report flag is set 
to 1, and the showmode and novice flags are set. These defaults 
make it easier to get started learning the editor. 


Vi MODES 


Command Normal and initial mode. Other modes return to 


command mode upon completion. 


is used to cancel a partial command. 


Input Entered byaiAloOcCsSR. Arbitrary text 
may then be entered. Input mode is normally ter- 
minated with ESC character, or abnormally with 


interrupt. 


ESC (escape) 


Last line Reading input for : / ? or !; terminate with CR to 
execute, interrupt to cancel. 


COMMAND SUMMARY 
Sample commands 
« S‘t—- 
hjkl 
itextESC 
cwnewESC 
easESC 
x 
dw 
dd 
3dd 
u 
22 
:qiCR 
/textCR 
“U °*D 
“ex cmdCR 
Counts before vi commands 


Numbers may be typed as a prefix to some commands. 


arrow keys move the cursor 
same as arrow keys 
insert text abc 

change word to new 
pluralize word 

delete a character 
delete a word 

delete a line 

.. 3 lines 

undo previous change 
exit vi, saving changes 
quit, discarding changes 
search for text 

scroll up or down 

any ex or ed command 


interpreted in one of these ways. 


line/column number 
scroll amount 
repeat effect 


Interrupting, canceling 


zG| 
“‘D *U 
most of the rest 


ESC end insert or incomplete cmd 
“9? (delete or rubout) interrupts 

“L reprint screen if “? scrambles it 
‘R reprint screen if “L is ~ key 
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:wCR write back changes 

:qCR quit 

:qiCR quit, discard changes 

:e nameCR edit file name 

-e!CR reedit, discard changes 

7e + nameCR edit, starting at end 

7e +nCR edit starting at line n 

7e #CR edit alternate file 
synonym for :e # 

:w nameCR write file name 

:w! nameCR overwrite file name 

:shCR run shell, then return 

:IcmdCR run cmd, then return 

:nCR edit next file in arglist 

in argsCR specify new arglist 

‘°G show current file and line 

ta fagCR to tag file entry tag 


] 


:ta, following word is tag 


In general, any ex or ed command (such as substitute or global ) 
may be typed, preceded by a colon and followed by a CR. 


Positioning within file 


"FP forward screen 

*B backward screen 

“D scroll down half screen 
“U scroll up half screen 

G go to specified line (end default) 
/pat next line matching pat 
?pat prev line matching pat 

n repeat last / or ? 

N reverse last / or ? 
/pat/+n noth line after pat 
?pat?—-n noth line before pat 

1] next section/function 

[[ previous section/function 
( beginning of sentence 

) end of sentence 

{ beginning of paragraph 

} end of paragraph 

% find matching ( ) { or } 


Adjusting the screen 


“L clear and redraw 
“R retype, eliminate @ lines 
zCR redraw, current at window top 
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z—-CR ... at bottom 

z.CR ... at center 

/pat/z—CR pat line at bottom 

zn.CR use n line window 

“E scroll window down 1 line 

“y scroll window up 1 line 
Marking and returning 

- move cursor to previous context 

< ... at first non-white in line 

mx mark Current position with letter x 

~x move cursor to mark x 

x ... at first non-white in line 
Line positioning 

H top line on screen 

L last line on screen 

M middle line on screen 

+ next line, at first non-white 

- previous line, at first non-white 

CR return, same as + 

tor j next line, same column 

tork previous line, same column 
Character positioning | 

. first non white 

0 beginning of line 

$ end of line 

hor - forward 

lor <« backwards 

“H same as <« 

space same as > 

fx find x forward 

Fx f backward 

tx upto x forward 

Tx back upto x 

; repeat last f F tor T 

: inverse of ; 

| to specified column 

% find matching { { ) or } 
Words, sentences, paragraphs 

Ww word forward 

b back word 

e end of word 

) to next sentence 

} to next paragraph 
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( back sentence 
{ back paragraph a 
Ww blank delimited word a 
B back W 
E to end of W 
Commands for LISP Mode 
) Forward s-expression 
} ... but do not stop at atoms 
( Back s-expression 
{ ... but do not stop at atoms 
Corrections during insert 
“H erase last character 
“W erase last word 
erase your erase, same as “H 
kill your kill, erase input this line 
\ quotes *H, your erase and kill 
ESC ends insertion, back to command 
*? interrupt, terminates insert 
“D backtab over autoindent 
rD kill autoindent, save for next 
0°D ... but at margin next also 
‘Vv quote non-printing character —- 
Insert and replace a 


a append after cursor 

i insert before cursor 

A append at end of line 

I insert before first non-blank 
re) open line below 


O open above 

rx replace single char with x 

RtextESC replace characters 
Operators 


Operators are followed by a cursor motion, and affect all text that 
would have been moved over. For example, since w moves over a 
word, dw deletes the word that would be moved over. Double the 
operator, e.g. dd to affect whole lines. 

delete 

change 

yank lines to buffer 

left shift 

right shift 

filter through command | 
indent for LISP NX 


=V AX OG 


| 
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Miscellaneous Operations 

change rest of line (c$) 
delete rest of line (d$) 
substitute chars (cl) 
substitute lines (cc) 
join lines 

delete characters (dl) 
... before cursor (dh) 
yank lines (yy) 


<x<xxeMnoo 


Yank and Put 
Put inserts the text most recently deleted or yanked. However, if a 
buffer is named, the text in that buffer is put instead. 


p put back text after cursor 
P put before cursor 

"xp put from buffer x 

"xy yank to buffer x 

"xd delete into buffer x 


Undo, Redo, Retrieve 


Uu undo last change 
U restore current line 
o : repeat last change 
( "dp retrieve a’th last delete 
AUTHOR 


Vi and ex were developed by The University of California, Berkeley 
California, Computer Science Division, Department of Electrical 
Engineering and Computer Science. 


SEE ALSO 
ex (1). 


Vi Quick Reference Card. 
An Introduction to Display Editing with Vi, and Ex Reference 
Manual in the Sys5 UNIX Documentation Workbench. 


CAVEATS AND BUGS 
Software tabs using “T work only immediately after the autoindent. 


Left and right shifts on intelligent terminals do not make use of insert 
and delete character operations in the terminal. 


There should be an interactive help facility and a tutorial suited for 
beginners. 
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NAME 


vtty - connect to a remote host via NOS 


SYNOPSIS 


vtty host 


DESCRIPTION 


Vity establishes a cu(1) link between one UNIX system and another. 
Both systems must be running the Plexus Network Operating Sys- 
tem (NOS). 


Vtty scans the file /usrlib/-nos'vtconf for the host name specified, 
and remembers the minor device number(s) associated with that 
host. It then searches the directory /dev for special files that have 
that minor device number. If it finds an entries in /dev within the 
appropriate minor device number range, it checks /usr’spool/uucp 
for lock files associated with these devices, and initiates a cu pro- 
cess with the first available device. 


All normal setup for cu and the virtual terminal facility of NOS must 
be done on both nodes for this command to work. In particular, the 
file /usr/lib/uucp/L-devices must be set up properly, and virtual ter- 
minals and ports must be established in all connecting nodes’ /dev 
directories and configured in their /usr/lib/nos/vtconf files. 


FILES 
‘usr lib/nos/vtconf virtual terminal/port configuration 
file 
/ust Spool/uucp cu lock files here 
idev:* virtual terminal ports located here 
/ usr spool/uucp/L-devices virtual terminals defined for vtty 
fetc:inittab virtual ports activated on receiving 
host 

EXAMPLE 


Assuming the system pix is running NOS, and one or more virtual 
ports have been established on plx in /dev, and the local host's 
/usrilib/nos/vtconf file and /dev directory have assigned at least 
one virtual terminal to pix, you can connect to plx by typing 


> vity pix 
lf successful, the message 
Connected 


appears, followed by the normal login prompt. 


DIAGNOSTICS 
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Cannot open dev 
The directory dev cannot be accessed. 
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BUGS 


Cannot open /usr/libinos'vtconf 
The file /usr/lib/nos’vtconf cannot be opened or does not exist. 


<name> not found in vtconf 
The host name name is not a configured host. 


No vt device available. Try again. 
All ports are in use. Try again later. 


time-out to remote host 
The remote host is down or not enabled; or the local host is not 
enabled on the remote host. See node(1). 


time-out period not expired 

time-out to remote host 

After receiving the time-out to remote host on the previous vtty 
request, the time-out period has not expired. 


/usr/libinosivtconf on remote host does not allow remote login. 
/usr/lib/nos’vtconf on the remote host does not have a logical dev- 
ice defined to receive remote logins. 


device not defined for virtual terminal in jusr‘libinos’vtcont. 
User attempted to cu to a device not defined in /usr‘lib/nos‘vtconf. 


login port on remote host unavailable 
On the remote host, there is no getty for the virtual terminal port. 


There is no semaphore to prevent collisions between vity requests. 
Hence the error message indicating lack of devices may be errone- 
ous. 
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NAME 
wait — await completion of process 

SYNOPSIS 
wait 

DESCRIPTION 
Wait until all processes started with & have completed, and report 
on abnormal terminations. 
Because the wait (2) system call must be executed in the parent 
process, the shell itself executes wait , without creating a new pro- 
cess. 

SEE ALSO 
sh(1). 
wait(2) in the Sys5 UNIX Programmer Reference Manual. 

BUGS 


Not all the processes of a 3- or more-stage pipeline are children of 
the shell, and thus cannot be waited for. 
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wc — word count 


SYNOPSIS 


we [ -lwe | [ names |] 


DESCRIPTION 
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Wc counts lines, words, and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for 
all named files. A word is a maximal string of characters delimited 
by spaces, tabs, or new-lines. 


The options |, w , and c may be used in any combination to specify 
that a subset of lines, words, and characters are to be reported. 
The default is -lwe . 


When names are specified on the command line, they will be 
printed along with the counts. 
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NAME 


what — identify SCCS files 


SYNOPSIS 


what [-s] files 


DESCRIPTION 


What searches the given files for all occurrences of the pattern that 
get (1) substitutes for %Z% (this is @(#) at this printing) and prints 
out what follows until the first ", > , new-line, \, or null character. 
For example, if the C program in file f.c contains 


char ident[] = "(a(#)identification information"; 
and f.c is compiled to yield f.o and a.out, then the command 


what f.c f.o a.out 


will print 
mon 
identification information 
f.o: 
identification information 
a.out: 


identification information 


What is intended to be used in conjunction with the command get 
(1), which automatically inserts identifying information, but it can 
also be used where the information is inserted manually. Only one 
option exists: 


-s Quit after finding the first occurrence of pat- 
tern in each file. 


SEE ALSO 


get(1), help(1). 


DIAGNOSTICS 


BUGS 
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Exit status is 0 if any matches are found, otherwise 1. Use help (1) 
for explanations. 


It is possible that an unintended occurrence of the pattern @(#) 
could be found just by chance, but this causes no harm in nearly all 
cases. 
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NAME 


who — who is on the system 


SYNOPSIS 


who [-uTHIpdbrtasq] [ file ] 
who am i 


who am | 


DESCRIPTION 
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Who can list the user’s name, terminal line, login time, elapsed time 
since activity occurred on the line, and the process-ID of the com- 
mand interpreter (shell) for each current UNIX system user. It exam- 
ines the /etc/utmp file to obtain its information. If file is given, that 
file is examined. Usually, file will be /etc/wtmp , which contains a 


history of all the logins since the file was last created. 


Who with the am i or am | option identifies the invoking user. 


Except for the default -s option, the general format for output 
entries is: 


name [state] line time activity pid [comment] [exit] 


With options, who can list logins, logoffs, reboots, and changes to 
the system clock, as well as other processes spawned by the init 
process. These options are: 


—U This option lists only those users who are currently logged in. 
The name is the user's login name. The line is the name of 
the line as found in the directory /dev . The time is the time 
that the user logged in. The activity is the number of hours 
and minutes since activity last occurred on that particular line. 
A dot (.) indicates that the terminal has seen activity in the 
last minute and is therefore ‘current’. If more than twenty- 
four hours have elapsed or the line has not been used since 
boot time, the entry is marked old. This field is useful when 
trying to determine whether a person is working at the termi- 
nal or not. The pid is the process-ID of the user's shell. The 
comment is the comment field associated with this line as 
found in /etc/inittab (see inittab (4)). This can contain infor- 
mation about where the terminal is located, the telephone 
number of the dataset, type of terminal if hard-wired, etc. 
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This option is the same as the —u option, except that the 
state of the terminal line is printed. The state describes 
whether someone else can write to that terminal. A + 
appears if the terminal is writable by anyone; a — appears if it 
is not. Root can write to all lines having a + or a — in the 
State field. If a bad line is encountered, a ? is printed. 


This option lists only those lines on which the system is wait- 
ing for someone to login. The name field is LOGIN in such 
cases. Other fields are the same as for user entries except 
that the state field does not exist. 


This option will print column headings above the regular out- 
put. 


This is a quick who, displaying only the names and the 
number of users currently logged on. When this option is 
used, all other options are ignored. 


This option lists any other process which is currently active 
and has been previously spawned by init. The name field is 
the name of the program executed by init as found in 
/etc/inittab . The state , line , and activity fields have no 
meaning. The comment field shows the /d field of the line 
from /etc/inittab that spawned this process. See inittab (4). 


This option displays all processes that have expired and not 
been respawned by init. The exit field appears for dead 
processes and contains the termination and exit values (as 
returned by wait (2)), of the dead process. This can be use- 
ful in determining why a process terminated. 


This option indicates the time and date of the last reboot. 
This option indicates the current run-level of the init process. 


This option indicates the last change to the system clock (via 
the date (1) command) by root . See su (7). 


This option processes /etc/utmp or the named file with all 
options turned on. 


This option is the default and lists only the name , line , and 
time fields. 


/etc/utmp 
/etc/wtmp 
/etc/inittab 


SEE ALSO 


date(1), login(1), mesg(1), su(1). 
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wait(2), inittab(4), utmp(4) in the Sys5 UNIX Programmer Reference 


| Manual. 
( init(1M) in the Sys5 UNIX Administrator Reference Manual. 
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NAME 


write — write to another user 


SYNOPSIS 


write user [ line ] 


DESCRIPTION 
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Write copies lines from your terminal to that of another user. When 
first called, it sends the message: 


Message from yourname (tty ?? ) [ date ]... 


to the person you want to talk to. When it has successfully com- 
pleted the connection, it also sends two bells to your own terminal to 
indicate that what you are typing is being sent. 


The recipient of the message should write back at this point. Com- 
munication continues until an end of file is read from the terminal, 
an interrupt is sent, or the recipient has executed "mesg n". At that 
point write writes EOT on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the 
line argument may be used to indicate which line or terminal to send 
to (e.g., ttyOO ); otherwise, the first writable instance of the user 
found in /etc/utmp is assumed and the following message posted: 


user is logged on more than one place. 
You are connected to “terminal”. 

Other locations are: 

terminal 


Permission to write may be denied or granted by use of the 
mesg(1) command. Writing to others is normally allowed by default. 
Certain commands, in particular nroff (1) and pr (7) disallow mes- 
sages in order to prevent interference with their output. However, if 
the user has super-user permissions, messages can be forced onto 
a write-inhibited terminal. 


If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 


The following protocol is suggested for using write : when you first 
write to another user, wait for them to write back before starting to 
send. Each person should end a message with a distinctive signal 
(i.e., (0) for “over’) so that the other person knows when to reply. 
The signal (00) (for “over and out”) is suggested when conversation 
is to be terminated. 
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FILES 
/etc/utmp to find user 
/bin/sh to execute ! 
SEE ALSO 
mail(1), mesg(1), nroff(1), pr(1), sh(1), who(1). 
Sys5 UNIX Documenter’s Workbench Introduction and Reference 
Manual. 
DIAGNOSTICS 


“user is not logged on” if the person you are trying to write to is 
not logged on. 

“Permission denied” if the person you are trying to write to denies 
that permission (with mesg). 
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x9700 - prepare nroff documents for the Xerox 9700 printer 


SYNOPSIS 
x9700 [-1 | -2] [ [-f] file] [-h indent] [-v indent] [-I leng] 
[-{ pil] k mask [n] ] [ [-o orient] [-s style] [-T c] [files] 


DESCRIPTION 
The x9700 command reads the named files and writes standard out- 
put which is suitable to be sent to the Xerox 9700 printer. The spe- 
cial name — means standard input. Each file will begin on a new 
page. If no files are specified, then x9700 reads from standard 
input. Options and their meanings: 


—1 
—2 
—f file 


—h indent 


—v indent 


—I /ength 


—Ik mask n 
—pk mask n 
—k mask n 


—o orient 


print output on one side of the page 
print output on both sides of the page 


Take input from file. This option is necessary to pro- 
cess file names which begin with a hyphen. 


horizontal indent: offset output indent units to the right. 
A c appended to indent sets the unit of offset to cen- 
timeters; an /, sets the unit to inches; neither, sets the 
unit to character positions. The default indent is zero. 
Fractional character positions are ignored. 


Vertical indent: offset output indent lines from top of 
page. Default is zero. 


Print /ength lines per page. Defaults for the fonts are 
given below. A /ength of zero obtains the default. 


Overlay output with preprinted mask. The /k overlays 
the mask in landscape orientation; the pk, in portrait 
Orientation. The k alone uses the current orientation. 
The default mask is none. A number following the 
mask name specifies the page on which to overlay the 
mask. If no number follows the mask name, then all 
pages not specifically named are overlaid with the 
mask. Available masks are installation-dependant. 


Page orientation, either portrait or landscape, with 
port and /and respectively, acceptable abbreviations. 
Each font style has a default, given below. Specifying 
an empty orientation obtains the default. 
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—s style Select font style. Current possibilities and default 
values: 
style abbr = default portrait landscape 
orient length width length width 
elite elit port 71 102 opi 131 
gothic goth port 66 85 oF 110 
goth24 port 33 42 25 95 
mini port 137 og 106 131 
pica port 66 85 51 110 
times14 port 46 “90 36 “118 
times28 port 23. “45 18 “Og 
vintage —vint port 71 102 55 131 
vint20 port 35 1 27 66 
xerox xrox land 99 116 77 131 
xerox18 land 44 08 34 AS) 


Note that the lengths and widths are maximum values 
for a page and make no provision for margins. The © 
indicates approximate widths for proportionally spaced 
fonts. The default style is vintage. Both the style 
names and their abbreviations are accepted. Not all 
styles have all fonts, and not all fonts have a full char- 
acter set (including the full TX train). A summary of 
available combinations appears below. Note: these 
fonts are under development and subject to 
change without notice. 


-TCc If and only if c ts X, then x9700 expects input from 
nroff with the -TX option. 


Options may be repeated and may appear in any order. The space 
between an option and its argument may be omitted. The options 
are cumulative and apply only to succeeding file names. Thus 


x9700 -o port -h 10 file1 -o land file2 


prints file? in portrait orientation and file2 in landscape, but indents 
both files by 10 characters. 
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ESCAPES , 

The command xX9700 recognizes four control characters (back- 
space, formfeed, horizontal tab, and carriage return) and the follow- 
ing set of escapes: 


escape sequence meaning from NROFF 
esc XC hyperascii c (‘c’ | 0200) 

eSC eSc C hyperascii c (‘c' | 0200) 

esc B bold font \fB 
esc R Roman font \fR 
esc | Italic font \fl 
esc L logo font 

esc D reverse half-line feed ) 
esc U half-line feed \d 
esc \n reverse line feed 

esc SI intensify shading 

esc SO lessen shading 


The half-line motions effect superscripts and subscripts, but the TX 
train contains only a limited number of these. There are three levels 
of shading available: dark (character e9), darker (e8), and darkest 


(c4). 
input this column to get 
none none 
\33\1 7level 1 (dark) level 1 (dark) 
\33\1 7level 2 (darker) level 2 (darker) 
\33\1 7level 3 (darkest) level 3 (darkest) 
\33\16back to level 2 back to level 2 
\33\16back to level 1 back to level 1 
\33\16back to none back to none 
SEE ALSO 
nroff(1). 
EXCEPTIONS 


Lines that exceed the page width are truncated. Page breaks occur 
not only at the logical end of page (controlled by the -I option), but 
also at the physical end of page (controlled by the machine). Lines 
which exceed the latter limit are usually forced to an extra, overflow 
page. The number of lines on a page includes the indent of the -v 
option. 


It is difficult to get to all of the 7X train. 
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FONT SUMMARY 


style bold-italic graph 
port land port land 


elite y y n n 
Gothic y y n n 
goth24 n n n n 
mini n n n n 
pica y y n n 
times14 n n n n 
times28 n n n n 
vintage y y y y 
vint20 n n y y 
Xerox y y n n 
xerox18 n n n n 


DIAGNOSTICS 
"missing parameter to -option” 
"cant open file" 
"unsupported style/orientation combination" 
"bad mask name" 
"bad horizontal indent specification" 
"Dad page length specification’ 
“bad vertical indent specification” 


Check parameter list. 


"nage length larger than max" 


X9700 has been directed to place more than 140 lines 
On a page. 


"attempt to back off page’ 


An attempt to field a reverse line feed would cause a 
return to a previous page. 


"tile too wide" 


X9700 has encountered a line with more than 132 char- 
acters on it. This usually happens when input not pro- 
duced with nroff-TX is given to x9700 with the -7X 
option. 


“unknown escape sequence” 


X9700 has been given an escape sequence which does 
not correspond to a reverse line feed, a font change, a 
shade change, or a hyperascii character. Escape 
sequences are introduced with an ascii esc character 
(octal 33). This usually happens when -7X is not sup- 
plied to nroff. 
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"too many masks" 
X9700 allows a total of only ten separate mask specifi- 
cations. 


“page too dense" 
X9700 has encountered a page with too much over- 
printing. The cause may be too much backspacing or 
too many font changes. It may be small comfort that 
even if the x9700 program could format the page, the 
Xerox printer would probably fai! to print it. 


"internal error” 
"machine seized" 
Get help. 


EXAMPLES | 
The following examples do not include the final pipeline to direct the 
output to the Xerox 9700 printer, because that Is an installation- 
dependent procedure. 


To obtain standard memo format: 
nroff -rA3 -rE1 -rU1 -rL71 -TX -cm file | 
x9700 -h10 -TX -k print 

To obtain manual page: 


nroff -TX -man file | 
x9700 -I66 -v3 -h10 -TX rad 
To obtain this manual page: 
nroff -man -TX file | 
x9700 -h12 -v2 -I66 -TX -k print 1 -k prin2 2 -k prin3 3 \ 
-Ik print 4 -lk prin2 5 -k vgraf 6 -k sdisc 7 
To obtain viewgraphs: 
nroff -TX - file <<eof | 
.pl 35 
A 45 


eof 
x9700 -s vint20 -TX 
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NAME 


xargs — construct argument list(s) and execute command 


SYNOPSIS 


xargs [flags] [ command [initial-arguments ] ] 


DESCRIPTION 
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Xargs combines the fixed initial-arguments with arguments read 
from standard input to execute the specified command one or more 
times. The number of arguments read for each command invoca- 
tion and the manner in which they are combined are determined by 
the flags specified. 


Command , which may be a shell file, is searched for, using one's 
$PATH. If command is omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new- 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted. Characters 
enclosed in quotes (single or double) are taken literally, and the del- 
imiting quotes are removed. Outside of quoted strings a backslash 
(\) will escape the next character. 


Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(Exception: see —i flag). Flags -i, -l, and —n determine how argu- 
ments are selected for each command invocation. When none of 
these flags are coded, the initial-arguments are followed by argu- 
ments read continuously from standard input until an internal buffer 
is full, and then command is executed with the accumulated args. 
This process is repeated until there are no more args. When there 
are flag conflicts (e.g., -l vs. —n ), the last flag has precedence. 
Flag values are: 


—Inumber Command is executed for each non-empty 
number lines of arguments from standard 
input. The last invocation of command will 
be with fewer lines of arguments if fewer than 
number remain. A line is considered to end 
with the first new-line unless the last charac- 
ter of the line is a blank or a tab; a trailing 
blank/tab signals continuation through the 
next non-empty line. If number is omitted, 1 
is assumed. Option —x is forced. 
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—ireplstr 


—nnumber 


—P 


—X 


May 19, 1986 


UNIX Sys5 XARGS(1) 


Insert mode: command is executed for each 
line from standard input, taking the entire line 
as a single arg, inserting it in initial- 
arguments for each occurrence of repi/str. A 
maximum of 5 arguments in initial-arguments 
may each contain one or more instances of 
replstr . Blanks and tabs at the beginning of 
each line are thrown away. Constructed 
arguments may not grow larger than 255 
characters, and option —x is also forced. {} 
is assumed for repistr if not specified. 


Execute command using as many standard 
input arguments as possible, up to number 
arguments maximum. Fewer arguments will 
be used if their total size is greater than size 
characters, and for the last invocation if there 
are fewer than number arguments remaining. 
If option —x is also coded, each number argu- 
ments must fit in the size limitation, else 
xargs terminates execution. 


Trace mode: The command and each con- 
structed argument list are echoed to file 
descriptor 2 just prior to their execution. 


Prompt mode: The user is asked whether to 
execute command each invocation. Trace 
mode (—t) is turned on to print the command 
instance to be executed, followed by a ?... 
prompt. A reply of y (optionally followed by 
anything) will execute the command; anything 
else, including just a carriage return, skips 
that particular invocation of command . 


Causes xargs to terminate if any argument 
list would be greater than size characters; —x 
is forced by the options —i and -! . When net- 
ther of the options -i , -I , or —n are coded, 
the total length of all arguments must be 
within the size limit. 
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—ssize The maximum total size of each argument list 
is set to size characters; size must be a posi- 
tive integer less than or equal to 470. If —s is 
not coded, 470 is taken as the default. Note 
that the character count for size includes one 
extra character for each argument and the 
count of characters in the command name. 


—eeofstr Eofstr is taken as the logical end-of-file string. 
Underbar (_) is assumed for the logical EOF 
string if -e is not coded. The value -—e with 
no eofstr coded turns off the logical EOF 
string capability (underbar is taken literally). 
Xargs reads standard input until either end- 
of-file or the logical EOF string is encoun- 
tered. | 


Xargs will terminate if either it receives a return code of —1 from, or 
if it cannot execute, command . When command is a shell program, 
it should explicitly exit (see sh (1)) with an appropriate value to 
avoid accidentally returning with -1. 


EXAMPLES 


The following will move all files from directory $1 to directory $2, and 
echo each move command just before doing it: 


Ils $1 | xargs -i -t mv $14} $243 


The following will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 


(logname; date; echo $0 $«) | xargs >>log 


The user is asked which files in the current directory are to be 
archived and archives them into arch (1.) one at a time, or (2.) 
many at a time. 


1. Is | xargs —p +I ar r arch 
2. Is | xargs —p -1 | xargs ar r arch 


The following will execute diff (7) with successive pairs of argu- 
ments originally typed as shell arguments: 


echo $* | xargs —n2 diff 


SEE ALSO 


sh(1). 


DIAGNOSTICS 
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NAME 


xstr — extract strings from C programs to implement shared strings 


SYNOPSIS 


/usr/plix/xstr [ -—c | [ — ] [ file | 


DESCRIPTION 
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Xstr maintains a file strings into which strings in component parts of 
a large program are hashed. These strings are replaced with refer- 
ences to this common area. This serves to implement shared con- 
stant strings, most useful if they are also read-only. 


The command 
xstr —c name 


will extract the strings from the C source in name, replacing string 
references by expressions of the form (&xstr[number]) for some 
number. An approporiate declaration of xstr is prepended to the file. 
The resulting C text is placed in the file x.c, to then be compiled. 
The strings from this file are placed in the strings data base if they 
are not there already. Repeated strings and strings which are suf- 
fices of existing strings do not cause changes to the data base. 


After all components of a large program have been compiled a file 
xs.c declaring the common xstr space can be created by a com- 
mand of the form 


xstr 


This xs.c file should then be compiled and loaded with the rest of 
the program. If possible, the array can be made read-only (shared) 
Saving space and swap overhead. 


Xstr can also be used on a single file. A command 
xstr name 


creates files x.c and xs.c as before, without using or affecting any 
Strings file in the same directory. 


It may be useful to run xsétr after the C preprocessor if any macro 
definitions yield strings or if there is conditional code which contains 
strings which may not, in fact, be needed. Xstr reads from its stan- 
dard input when the argument —' is given. An appropriate com- 
mand sequence for running xstr after the C preprocessor is: 


cc -E name.c| xstr -c — 
CC -C X.C 
mv x.o name.o 


Xstr does not touch the file strings unless new items are added, 
thus make can avoid remaking xs.o unless truly necessary. 
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FILES 
strings Data base of strings FOX 
X.C Massaged C source ae. 
XS.C C source for definition of array ‘xstr’ “= 
/tmp/xs* Temp file when ‘xstr name’ doesnt touch strings 

NOTES 


This command is based on a similar one from the University of Cali- 
fornia at Berkeley. 


SEE ALSO 
mkstr(1) 


BUGS 
lf a string is a suffix of another string in the data base, but the 
shorter string is seen first by xsfr both strings will be placed in the 
data base, when just placing the longer one there will do. 
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NAME 
yacc — yet another compiler-compiler 


SYNOPSIS 
yacc [ —vdit | grammar 


DESCRIPTION 
Yacc converts a context-free grammar into a set of tables for a sim- 
ple automaton which executes an LR(1) parsing algorithm. The 
grammar may be ambiguous; specified precedence rules are used 
to break ambiguities. 


The output file, y.tab.c , must be compiled by the C compiler to pro- 
duce a program yyparse . This program must be loaded with the 
lexical analyzer program, yylex , as well aS main and yyerror , an 
error handling routine. These routines must be supplied by the 
user; /ex (7) is useful for creating lexical analyzers usable by yacc . 


If the —v flag is given, the file y.output is prepared, which contains a 
description of the parsing tables and a report on conflicts generated 
by ambiguities in the grammar. 


If the —d flag is used, the file y.tab.h is generated with the #define 
statements that associate the yacc-assigned “token codes’ with the 

Bs user-declared “token names’. This allows source files other than 
( y.tab.c to access the token codes. 


If the —I flag is given, the code produced in y.tab.c will nof contain 
any #line constructs. This should only be used after the grammar 
and the associated actions are fully debugged. 


Runtime debugging code is always generated in y.tab.c under con- 
ditional compilation control. By default, this code is not included 
when y.tab.c is compiled. However, when yacc ‘s -t option is 
used, this debugging code will be compiled by default. Independent 
of whether the -t option was used, the runtime debugging code is 
under the control of YYDEBUG , a pre-processor symbol. If YYDE- 
BUG has a non-zero value, then the debugging code is included. If 
its value is zero, then the code will not be included. The size and 
execution time of a program produced without the runtime debug- 
ging code will be smaller and slightly faster. 


FILES 
y.output 
y.tab.c 
y.tab.h defines for token names 
yacc.tmp, 
P< yacc.debug, yacc.acts temporary files 
( /usr/lib/yaccpar parser prototype for C programs 
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SEE ALSO 
lex(1). 
malloc(3X) in the Sys5 UNIX Programmer Reference Manual. 


YACC-—Yet Another Compiler Compiler in the Sys5 UNIX Support 
Tools Guide . 


DIAGNOSTICS 
The number of reduce-reduce and shift-reduce conflicts is reported 
on the standard error output; a more detailed report is found in the 
y-output file. Similarly, if some rules are not reachable from the 
start symbol, this is also reported. 


BUGS 
Because file names are fixed, at most one yacc process can be 
active in a given directory at a time. 
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NAME 
intro — introduction to games 
DESCRIPTION 
This section describes the recreational and educational programs 


found in the directory /usr/games . The availability of these pro- 
grams may vary from system to system. 
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NAME 


arithmetic — provide drill in number facts 


SYNOPSIS 


/usr/games/arithmetic [ +-x/ ] [ range | 


DESCRIPTION 
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Arithmetic types out simple arithmetic problems, and waits for an 
answer to be typed in. If the answer is correct, it types back 
“Right!”, and a new problem. If the answer is wrong, it replies 
“What?”, and waits for another answer. Every twenty problems, it 
publishes statistics on correctness and the time required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be 
generated; + ,-,x, and/ respectively cause addition, subtraction, 
multiplication, and division problems to be generated. One or more 
characters can be given; if more than one is given, the different 
types of problems will be mixed in random order; default is +—-. 


Range is a decimal number; all addends, subtrahends, differences, 
multiplicands, divisors, and quotients will be less than or equal to 
the value of range . Default range is 10. 


At the start, all numbers less than or equal to range are equally 
likely to appear. If the respondent makes a mistake, the numbers in 
the problem which was missed become more likely to reappear. 


As a matter of educational philosophy, the program will not give 
correct answers, since the learner should, in principle, be able to 
calculate them. Thus the program is intended to provide drill for 
someone just past the first learning stage, not to teach number facts 
de novo . For almost all users, the relevant statistic should be time 
per problem, not percent correct. 


May 22, 1985 


BACK(6) UNIX Sys5 BACK(6) 


NAME 


back — the game of backgammon 


SYNOPSIS 


/usr/games/back 


DESCRIPTION 
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Back is a program which provides a partner for the game of back- 
gammon. It is designed to play at three different levels of skill, one 
of which you must select. In addition to selecting the opponent's 
level, you may also indicate that you would like to roll your own dice 
during your turns (for the superstitious players). You will also be 
given the opportunity to move first. The practice of each player rol- 
ling one die for the first move is not incorporated. 


The points are numbered 1-24, with 1 being white’s extreme inner 
table, 24 being brown's inner table, O being the bar for removed 
white pieces and 25 the bar for brown. For details on how moves 
are expressed, type y when back asks “Instructions?” at the begin- 
ning of the game. When back first asks “Move?’, type ? to see a 
list of move options other than entering your numerical move. 


When the game is finished, back will ask you if you want the log. If 
you respond with y , back will attempt to append to or create a file 
back.log in the current directory. 


/usrigames/lib/backrules rules file 
/tmp/b* log temp file 
back.log log file 


The only level really worth playing is “expert”, and it only plays the 
forward game. 

Back will complain loudly if you attempt to make too many moves in 
a turn, but will become very silent if you make too few . 

Doubling is not implemented. 

Instructions tend to run off the page. 
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NAME 
bj — the game of black jack 


SYNOPSIS 
/usr/games/bj 


DESCRIPTION 
Bj is a serious attempt at simulating the dealer in the game of black 
jack (or twenty-one) as might be found in Reno. The following rules 


apply: 
The bet is $2 every hand. 


A player “natural” (black jack) pays $3. A dealer natural loses 
$2. Both dealer and player naturals is a “push” (no money 
exchange). 


If the dealer has an ace up, the player is allowed to make an 
“insurance” bet against the chance of a dealer natural. If this 
bet is not taken, play resumes as normal. If the bet is taken, it 
is a side bet where the player wins $2 if the dealer has a 
natural and loses $1 if the dealer does not. 


lf the player is dealt two cards of the same value, he its 
allowed to ‘double’. He is allowed to play two hands, each 
with one of these cards. (The bet is doubled also; $2 on each 
hand.) 


If a dealt hand has a total of ten or eleven, the player may 
“double down”. He may double the bet ($2 to $4) and receive 


y exactly one more card on that hand. 


Under normal play, the player may “hit” (draw a card) as long 
as his total is not over twenty-one. If the player “busts” (goes 
over twenty-one), the dealer wins the bet. 


When the player ‘stands’ (decides not to hit), the dealer hits 
until he attains a total of seventeen or more. If the dealer 
busts, the player wins the bet. 


If both player and dealer stand, the one with the largest total 
wins. A tie is a push. 


The machine deals and keeps score. The following questions will 
be asked at appropriate times. Each question is answered by y fol- 
lowed by a new-line for “yes”, or just new-line for “no”. | 


? (means, “do you want a hit?”) 
Insurance? 7 
Double down? 


Every time the deck is shuffled, the dealer so states and the 
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_ “action” (total bet) and “standing” (total won or lost) is printed. To 
( exit, hit the interrupt key (DEL) and the action and standing will be 
. printed. 


BUGS 
Doesn't work. 
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NAME 


craps — the game of craps 


SYNOPSIS 


/usr/games/craps 


DESCRIPTION 
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Craps is a form of the game of craps that is played in Las Vegas. 
The program simulates the roller , while the user (the player ) 
places bets. The player may choose, at any time, to bet with the 
roller or with the House . A bet of a negative amount is taken as a 
bet with the House, any other bet is a bet with the roller. 


The player starts off with a “bankroll” of $2,000. 
The program prompts with: 
bet? 
The bet can be all or part of the player’s bankroll. Any bet over the 


total bankroll is rejected and the program prompts with bet? until a 
proper bet is made. 


Once the bet is accepted, the roller throws the dice. The following 
rules apply (the player wins or loses depending on whether the bet 
is placed with the roller or with the House; the odds are even). The 
first roll is the roll immediately following a bet: 


1. On the first roll: 


7 or 11 wins for the roller; 
2,3, or 12 wins for the House; 
any other number is the point , roll again (Rule 2 
applies). 
2. On subsequent rolls: 
point roller wins; 
7 House wins; 


any other number roll again. 


If a player loses the entire bankroll, the House will offer to lend the 
player an additional $2,000. The program will prompt: 


marker? 


A yes (or y ) consummates the loan. Any other reply terminates the 
game. 


lf a player owes the House money, the House reminds the player, 
before a bet is placed, how many markers are outstanding. 


If, at any time, the bankroll of a player who has outstanding markers 
exceeds $2,000, the House asks: 
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Repay marker? 


A reply of yes (or y ) indicates the player's willingness to repay the 
loan. If only 1 marker is outstanding, it is immediately repaid. How- 
ever, if more than 1 marker are outstanding, the House asks: 


How many? 


markers the player would like to repay. If an invalid number is 
entered (or just a carriage return), an appropriate message is 
printed and the program will prompt with How many? until a valid 
number is entered. 


lf a player accumulates 10 markers (a total of $20,000 borrowed 
from the House), the program informs the player of the situation and 
exits. 


Should the bankroll of a player who has outstanding markers 
exceed $50,000, the tota/ amount of money borrowed will be 
automatically repaid to the House. 


Any player who accumulates $100,000 or more breaks the bank. 
The program then prompts: 


New game? 
to give the House a chance to win back its money. 


Any reply other than yes is considered to be a no (except in the 
case of bet? or How many? ). To exit, send an interrupt (break), 
DEL, or control-D. The program will indicate whether the player 
won, lost, or broke even. 


MISCELLANEOUS 


The random number generator for the die numbers uses the 
seconds from the time of day. Depending on system usage, these 
numbers, at times, may seem strange but occurrences of this type 
in a real dice situation are not uncommon. 
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NAME 

hangman — guess the word 
SYNOPSIS 

/usr/games/hangman [ arg | 
DESCRIPTION 


Hangman chooses a word at least seven letters long from a diction- 
ary. The user is to guess letters one at a time. 


The optional argument arg names an alternate dictionary. 


FILES 
/usrilib/w2006 


BUGS 
Hyphenated compounds are run together. 
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NAME 
maze — generate a maze 


SYNOPSIS 
/usr/games/maze 


DESCRIPTION 
Maze asks a few questions and then prints a maze. 


BUGS 
Some mazes (especially small ones) have no solutions. 
Doesn't ask any questions and doesn't fit on a screen. 
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NAME 
moo — guessing game 


SYNOPSIS 
/usr/games/moo 


DESCRIPTION | 
Moo is a guessing game imported from England. The computer 
picks a number consisting of four distinct decimal! digits. The player 
guesses four distinct digits being scored on each guess. A ‘cow’ is 
a correct digit in an incorrect position. A “bull” is a correct digit in a 
correct position. The game continues until the player guesses the 
number (a score of four bulls). 
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NAME 
quiz — test your knowledge 
SYNOPSIS 
/usr/games/quiz [ —i file | [ -t ] [ category1 category2 |] 
DESCRIPTION 
Quiz gives associative knowledge tests on various subjects. It asks 
items chosen from category? and expects answers from category2 
, or vice versa. If no categories are specified, quiz gives instruc- 
tions and lists the available categories. 
Quiz tells a correct answer whenever you type a bare new-line. At 
the end of input, upon interrupt, or when questions run out, quiz 
reports a score and terminates. 
The —t flag specifies “tutorial” mode, where missed questions are 
repeated later, and material is gradually introduced as you learn. 
The -i flag causes the named file to be substituted for the default 
index file. The lines of these files have the syntax: 
line = category new-line | category : line 
category = alternate | category | alternate 
alternate = empty | alternate primary 
primary = character |{ category ] | option 
option = { category } 
The first category on each line of an index file names an information 
file. The remaining categories specify the order and contents of the 
data in each line of the information file. Information files have the 
same syntax. Backslash \ is used as with sh (7) to quote syntacti- 
cally significant characters or to insert transparent new-lines into a 
line. When either a question or its answer is empty, quiz will refrain 
from asking it. 
FILES 
/ust/games/lib: quiz/index 
/ust/games/lib/quiz/* 
BUGS 
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The construct “al|ab’” does not work in an information file. Use 
“ajb}”. 

Instructions scroll off-screen. Pipe to pg or more. Requires exact 
spelling. 
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NAME 
wump — the game of hunt-the-wumpus 


SYNOPSIS 
/usr/games/wump 


DESCRIPTION 
Wump plays the game of “Hunt the Wumpus.” A Wumous is a 
creature that lives in a cave with several rooms connected by tun- 
nels. You wander among the rooms, trying to shoot the Wumpus 
with an arrow, meanwhile avoiding being eaten by the Wumpus and 
falling into Bottomless Pits. There are also Super Bats which are 
likely to pick you up and drop you in some random room. 


The program asks various questions which you answer one per line; 
it will give a more detailed description if you want. 


This program is based on one described in People’s Computer 
Company , 2, 2 (November 1973). 


BUGS 
It will never replace Adventure. 
Instructions run off the screen. 
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